Creating a Voice API application on the Legacy North American Platform

David Preo

Updated

Note: This article contains steps specific to our Legacy North American Platform. If you're using our Universal Platform, please see Creating a Voice API application on the Universal Platform

To begin using your Bandwidth App numbers for Voice APIs, you first need to create a Voice application and then associate it with your phone number’s location:

  1. Log in to the Bandwidth App.
  2. Create a Sub-account (if you already have a Sub-account that you want to associate with this application, you can skip this step). 
  3. In the side navigation bar, select Applications.
  4. Provide the Application name (we recommend you use something that identifies what the application will do).
  5. Under Application type, select Voice (you won’t be able to change this once the application is created).
  6. Enable the Use a callback username and password checkbox if you’d like to use a callback username and password. Your password won’t be visible after leaving this screen, so please store it securely for your use or return here to create a new one.
  7. Under Call initiated callback method, select GET or POST.
  8. Under Call status callback method, select GET or POST (optional).
  9. Enter a Call initiated callback URL (invoked when a call is initiated).
  10. Enter a Call status callback URL (optional). Currently this is invoked when a call is terminated, but other status events may be added in the future.
  11. If you checked the Use a callback username and password, please enter the Callback user ID and Callback password. These credentials will be used by your server to authenticate callbacks.
  12. Click Create Application.

voice-application.png

Next, you need to associate your new Location with your Voice application.

  1. In the side navigation bar, click Account and select Locations.
  2. Click Add Location and complete the following fields:
    • Name: Provide a name for this Location.
    • Description: Enter a description for this Location (optional).
    • Sub-account: Select a Sub-account that you want to associate with this Location.
    • Default Location: Turn this on if you'd like this to be your primary Location. This means when you order or port a number, this Location will show up first after you select your Sub-account.

create-location.png

  1. Switch to the Voice tab.
  2. Under Voice method, select HTTP.
  3. Under Associated voice application, select the application to associate with this Location.
  4. Adjust other settings based on your preference and click Create Location.

http-voice-method.png

Questions? Please open a ticket with your Bandwidth Support Team or hit us up at (855) 864-7776!

Article is closed for comments.