Applications

A Vonage application is a set of security and configuration information for connecting external accounts, numbers, and webhooks to the Vonage API.

You can use applications to:

  • Store authentication settings, external accounts, and webhooks for handling inbound and outbound traffic to and from Vonage APIs
  • Group related API capabilities under a single application ID and key pair
  • Control access and privacy settings for your integration

View Your Applications

To view a list of all your applications:

  1. Sign in to the Dashboard.
  2. Navigate to Applications.
Your Applications

The Your applications page shows all applications associated with your account. Each entry displays the application name, its creation date, and its unique application ID.

You can filter the list by API Key or Capabilities, and sort by last updated date. Use the grid or list icon to switch between view modes.

To create a new application, click + Create a new application in the top-right corner.

Create an Application

Create an application

To create a new application:

  1. Click + Create a new application.
  2. Enter a Name for your application. This is a friendly identifier for your own reference.
  3. The API key is pre-filled with your current account's API key. An application must be bound to a specific API key.
  4. Configure your authentication keys.
  5. Set your privacy preferences.
  6. Enable the capabilities you want to use.
  7. Click Create application.

Authentication

Vonage APIs (Voice, Messages, Conversation, etc) use JSON Web Tokens (JWTs) for authentication. JWTs must be signed with the private key of your application.

You can either generate a new key pair or provide your own public key:

  • Generate public and private key — Vonage generates a public and private key pair for you. The private key is downloaded to your machine immediately. Store it securely, as it cannot be retrieved again.
  • Enter a public key — If you already have a key pair, you can paste your public key directly.

Note: Keep your private key secure. It is used to sign JWTs that authenticate requests to Vonage APIs on behalf of your application.

Privacy

The Privacy section lets you control how your application's data is used.

Artificial intelligence - it allows use of data for AI training. See the data collection disclosure for details.

This toggle is off by default. You can enable or disable it at any time.

Capabilities

Capabilities determine which Vonage APIs your application can use. You can turn capabilities on and off at any time.

Application Capabilities

To enable a capability, toggle it on in the Capabilities section when creating or editing your application.

Capability Description
Voice Create calls, control calls in-progress, get information about previous calls, and more.
Messages Communicate with WhatsApp, Facebook Messenger, MMS and Viber.
RTC (In-app voice & messaging) (beta) Create conversations with in-app voice, in-app messaging, and custom events.
VBC Smart Numbers Vonage Business Communications customers can enable the Smart Numbers add-on.
Video (new) Create in-app video calls.
Verify V2 Enable your application with two-factor authentication.
Network Registry (new) Connect an approved registration for production, or enable Playground to access Network-powered features.

Note: You do not need to enable all capabilities. Only turn on the capabilities required for your integration. Each enabled capability may expose additional webhook configuration options.