Nexmo Application API

Name: Application API
Brand: Vonage Application API V2
Availability: InStock

★ Only Publicly Available OpenAPI DocumentCommunicationsVoice Telephonybasic5 EndpointsREST

Install Jentic One Beta

Connect the Application API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Application API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Application API.

Create a Vonage v2 application bundling voice, messages, RTC, and verify capability webhooks in one call

List paginated v2 applications scoped to the authenticated Vonage account

Update an application's per-capability webhooks and signed webhook secret without rotating its keys

GET STARTED

Start building with Application API

Explore with Jentic

View OpenAPI Document

For Agents

Provision and manage Vonage v2 applications — the multi-capability container that binds voice, messages, and verify webhooks to a Vonage account.

Use for: Create a new Vonage v2 application for messaging, List all my Vonage v2 applications, Get a Vonage application by id, Update the messages webhook on a Vonage application

Not supported: Does not place voice calls, send messages, provision numbers, or run verification — use for Vonage v2 application lifecycle and capability webhook configuration only.

Use Cases

Patterns agents use Application API for, with concrete tasks.

★ Provision a multi-channel application

Building a customer service experience that combines voice IVR and WhatsApp messaging requires a single Vonage v2 application with both voice and messages capabilities configured. POST / accepts a capabilities object that declares answer_url, event_url, inbound_url, and status_url per channel. Once created, the same application_id is used to mint JWTs for both the Voice API and the Messages API.

POST / with name 'support-bot', voice capability webhooks, and messages capability webhooks for the support tenant.

Rotate webhook URLs after backend migration

When a backend handler is moved to a new domain, every Vonage v2 application needs its webhook URLs updated. PUT /{id} replaces the capabilities block, preserving the application's signing key and number bindings. A migration script can iterate via GET / and PUT each application in sequence, finishing in minutes.

For each application_id from GET /, PUT /{id} with capabilities.voice.webhooks.answer_url set to the new domain.

Audit application inventory across an account

Compliance reviews require a periodic export of every active application, its enabled capabilities, and its webhook URLs. GET / paginates through the full list. A weekly cron can write the inventory to long-term storage for review against the deployment registry. Roughly half a day of work.

Iterate GET / with page and page_size until exhausted and write each id, name, and capability set to an inventory file.

Agent-driven tenant onboarding

An onboarding agent provisioning a new tenant searches Jentic for 'create a vonage application', loads the POST / schema, and executes with the tenant's webhook URLs and a generated key pair. Jentic's vault holds the API key and secret; the agent never handles the credentials directly.

Search Jentic for 'create a vonage application', load the schema, and POST / with the new tenant's name and capability webhooks.

Key Endpoints

5 endpoints — the vonage application api v2 (application.

METHOD

PATH

DESCRIPTION

GET

List available applications

POST

Create an application

GET

/{id}

Get an application

PUT

/{id}

Update an application

DELETE

/{id}

Delete an application

GET

List available applications

POST

Create an application

GET

/{id}

Get an application

PUT

/{id}

Update an application

DELETE

/{id}

Delete an application

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Vonage uses HTTP Basic auth with API key and API secret. Jentic stores both in the encrypted MAXsystem vault and injects them per call. The agent never sees the raw secret and credentials are scoped per workflow.

Intent-based discovery

Agents search by intent (e.g. 'check my Vonage account balance') and Jentic returns the matching Vonage operation with its input schema, so the agent calls the right endpoint without browsing developer.vonage.com.

Time to first call

Direct integration: 1-2 days for Basic auth, error handling, and balance checks. Through Jentic: under 30 minutes — search, load schema, execute.

FAQs

Specific to using Application API through Jentic.

What authentication does the Vonage Application API V2 use?

It uses HTTP Basic authentication with the Vonage API key and API secret. Jentic stores both in the encrypted MAXsystem vault and injects them per call so the agent never holds the raw secret.

Is the Vonage Application API V2 backwards compatible with v1?

Yes. Vonage states that applications created with v1 can also be managed via v2. The base path is /v2/applications and all v1 application_ids continue to resolve under v2 endpoints.

What are the rate limits for the Vonage Application API V2?

Application management is a control-plane API. Vonage does not publish a hard per-second cap in the spec; treat GET / pagination as eventually consistent and avoid hammering the endpoint in tight loops.

How do I create a v2 application through Jentic with the Vonage Application API V2?

Run pip install jentic, search Jentic for 'create a vonage application', load the POST / schema, and execute with the capabilities object. Credentials are pulled from the vault at call time.

Can I configure messages and voice capabilities on the same application with the Vonage Application API V2?

Yes. POST / and PUT /{id} accept a capabilities object with separate sub-objects for voice, messages, rtc, and verify, each with its own webhook URLs. A single application_id can carry several capabilities at once.

Does the Vonage Application API V2 return a private key on application creation?

Yes. POST / returns a keys.private_key in the response body that you must store immediately — Vonage does not retain it. The matching public_key is queryable via GET /{id} for verification.

Nexmo Application API

Connect the Application API to your agent

Capabilities

Start building with Application API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs