Buy a Number
You need to purchase a Vonage virtual number if you want to:
- Make or receive telephone calls with the Voice API
- Receive inbound SMS with the SMS API
- Use multichannel messaging with the Messages API
This page shows you how to buy a number programmatically.
You can also cancel a number online, using the developer dashboard or from the command line, using the Vonage CLI.
Replace the following variables in the sample code with your own values:
| Key | Description |
|---|---|
VONAGE_API_KEY | Your Vonage API key (see it on your dashboard). |
VONAGE_API_SECRET | Your Vonage API secret (also available on your dashboard). |
COUNTRY_CODE | The two digit country code for the number. For example: |
VONAGE_NUMBER | Your Vonage Number. E.g. |
Run your code
Save this file to your machine and run it:
Prerequisites
Create a file named buy.js and add the following code:
Run your code
Save this file to your machine and run it:
Prerequisites
Add the following to build.gradle:
Create a class named BuyNumber and add the following code to the main method:
Run your code
We can use the application plugin for Gradle to simplify the running of our application. Update your build.gradle with the following:
Run the following gradle command to execute your application, replacing com.vonage.quickstart.kt.numbers with the package containing BuyNumber:
Prerequisites
Add the following to build.gradle:
Create a class named BuyNumber and add the following code to the main method:
Run your code
We can use the application plugin for Gradle to simplify the running of our application. Update your build.gradle with the following:
Run the following gradle command to execute your application, replacing com.vonage.quickstart.numbers with the package containing BuyNumber:
Prerequisites
Create a file named BuyNumber.cs and add the following code:
Add the following to BuyNumber.cs:
Prerequisites
Create a file named purchase.php and add the following code:
Run your code
Save this file to your machine and run it:
Prerequisites
Run your code
Save this file to your machine and run it:
Prerequisites
Create a file named buy.rb and add the following code:
Run your code
Save this file to your machine and run it: