Getting Started with the Vonage Video API

Use this guide to get your first Vonage Video session running quickly — set up your account and application, then follow the quickstart to connect and stream.

Prerequisites

Create a Vonage account

Register for a free Vonage account.

After registering, you will be directed to the Vonage dashboard in order to create a new application.

Create an application

After logging into your Vonage dashboard, create an application for your Vonage video project.

  1. From the left-hand navigation click on Applications.
  2. From the Applications page, click on Create a new application to create a new application.
  3. Provide a name for your project.
  4. Click on Generate public and private key. You will generate a file containing your private key. Download and keep it safe, you will need it later.
  5. Scroll down, to the Capabilities list. Toggle the Video capability on.
  6. Click on Generate new application button.

Authentication

After your application is generated, you should be able to view multiple credentials. For now you need only two of them:

  • Application ID: This is a unique alphanumeric identifier for your video application.
  • Private key: This key is used for JWT-based authentication. Please ensure it is kept in a secure location.

You will need them to authenticate your application.

Build your first video session

With your dashboard credentials ready, use the Client and Server SDKs to create a session, issue tokens, and connect your app end-to-end. Follow this section to understand which credentials live on the server and how the client uses them to publish and subscribe.

To connect your client to its session, you need:

  • Application ID and private key — generated when you create the application; used for JWT-based authentication.
  • Session ID — identifies the session ("room"). See the sessions guide.
  • Token — short-lived credential that grants access and defines the client's role.

First, you'll need to install the Video SDK of your choice from the list below. Then, work through the Quickstart section to generate the Session ID and Token using the Server SDKs, return them to the client, then initialize the client and connect. See joining sessions for background.

Install the SDK

Pick the SDK that matches your client platform and follow its installation guide:

Quickstart

Follow these steps to go from backend credentials to a client that publishes and subscribes in a live session:

  1. Create a session — create a unique room on your server for clients to join.
  2. Generate a token — issue a short-lived credential (role/TTL) for each participant.
  3. Initialize a session and connect — set up the SDK with your Application ID + session ID, then connect using the token.
  4. Publish a stream — capture camera/microphone and send media to the session.
  5. Subscribe to streams — attach remote media to your UI and listen for stream events.

No backend yet? Try the Video API Playground to experiment with sessions.

What's Next

  • Recording videos: Learn how to capture, store, and retrieve sessions using automatic or on-demand archiving.
  • Verifying webhooks: Secure your callbacks with signature secrets so you can trust every event your app receives.
  • Video moderation: Enforce roles, force-disconnect, and mute participants to keep sessions under control.
  • Publisher settings: Tune camera, audio, and frame-rate properties for optimal quality per device.
  • Subscriber settings: Manage subscribers, respond to stream events, and customize the viewer experience.