Linking Numbers

Once you have rented a number through Vonage, you can link that number to an application using the CLI. If you do not already have a number, see Managing Numbers for a full list of commands to search and buy a new number.

List Numbers Linked to an Application

To list all the numbers linked to an application, run vonage apps numbers list <id>, where id is the UUID for the application. If you pass in the --fail flag, this command will exit with code 1 if the application does not have either messages or voice capabilities.

Note: This will continuously call the API to fetch all the numbers you have linked. This might take some time, depending on how many numbers you have.

vonage apps numbers list 00000000-0000-0000-0000-000000000000

✅ Fetching Application
Fetching numbers linked to application Your application [==============] 1/1 100%

There is 1 number linked:

Number       Country             Type       Features       
-----------  ------------------  ---------  ---------------
16127779311  🇺🇸 United States    Mobile     MMS, SMS, VOICE

Link / Unlink a Number to an Application

Numbers can be linked using vonage apps <link|unlink> <id> <msisdn>, where id is the UUID for the application, and msisdn is the number to be linked or unlinked.

Note: the --app-id and --private-key flags are ignored for this command.

vonage apps numbers link 00000000-0000-0000-0000-000000000000 16127779311

✅ Fetching Application
Fetching Owned numbers [===============================================] 1/1 100%

Number linked

Number: 16127779311
Country: 🇺🇸 United States
Type: Toll-free
Features: MMS, SMS, VOICE
Monthly Cost: Not Set
Setup Cost: Not Set
Linked Application ID: 00000000-0000-0000-0000-000000000000
Voice Callback: app
Voice Callback Value: 00000000-0000-0000-0000-000000000000
Voice Status Callback: Not Set