Getting Started

Welcome to the Vonage API platform! Vonage provides a suite of APIs that enable you to communicate with your customers using your preferred channels.

This site provides comprehensive documentation for all of our APIs and you’ll find everything you need to know about working with a particular API in the corresponding section.

However, there are some fundamental concepts that you need to understand and tools that might help you that apply across all our APIs. Here, we'll give you this information and get you up and running as quickly as possible.

What you will learn:

Signing up for an account

To work with our APIs, you will need to sign up for an account. This will give you an API key and secret that you can use to access our APIs.

Accessing the Developer Dashboard

Once you have an account, you can log into the Developer Dashboard. The Developer Dashboard is a GUI-based approach to managing your account, where you can:

Using the Vonage CLI

You can optionally perform many of the Dashboard tasks from the command line, using the Vonage CLI. This is often quicker and also allows you to script these operations.

The Vonage CLI is written with oclif and can be installed using the Node Package Manager (npm). The README in the Vonage CLI GitHub repo shows you how to install and work with the Vonage CLI.


When using the Vonage APIs your requests need to be authenticated. Typically this is done using Basic Authentication or JWTs. You can generate a suitable JWT using the Vonage CLI, or our online tool.

Experimenting with our APIs

Ultimately, you’re going to want to build an app in your chosen programming language. But to start with, you might want to make some sample requests to our APIs to check that you have provided the correct parameters and that you are getting back the responses you want.

If you are familiar with the command-line tool Curl, you will find Curl snippets for each of our APIs that you can copy, paste and modify.


Various GUI tools exist that are easier to use than Curl. A popular one is Postman. Read our guide on using Postman to work with our APIs. Vonage also provides a set of Postman collections, which provides a way to start using the APIs immediately.


Each of our APIs has its own OpenAPI specification. You can read more about OpenAPI in our documentation. Our specifications conform to OpenAPI specification version 3, also known as OAS3.

Using a Server SDK

When you are ready to start building your app, you’ll want to use one of our Server SDKs instead of coding each request by hand. We have SDKs for the following programming languages:

Click on the link for your chosen language to visit that SDK’s GitHub repo page, where you can learn how to install and use it.

Working with Webhooks

Once you have learned how to make requests to our APIs to place calls, send messages and so on you will want to learn how to receive inbound communications on your virtual number.

When our APIs want to notify your app about something - whether that is an inbound call or message or a status update - they require your app to expose a URL endpoint that our platform can make a request to. These must be accessible over the public Internet.

These endpoints are called Webhooks. Find out more about webhooks. Once you have created your web hook, you must tell our API platform to use it. The process for doing this depends on which API you are using and full instructions can be found in the documentation for that API.

Making these webhooks publicly-accessible during development can be tricky, so we recommend a tool called Ngrok.

Visit our guide on testing with Ngrok to learn how to use it.

What to do next

This guide introduced you to some of the fundamental concepts and tools that you should know about when working with our APIs.

Learn more in our Concepts and Tools sections.

Once you understand these fundamental concepts and have installed the tools you intend to use, you are ready to start building! View the documentation for your chosen API to get started, or try out some of the following starter tasks:

If you encounter any difficulties, check out our knowledge base and reach out for assistance if necessary at our support site.

We take pride in our documentation, but are always looking to make it better. So if you find anything that is unclear or lacking the information you require, then please submit feedback for the topic in question. If we’ve done a good job on a particular section then please let us know!