This is the API V2 documentation. To switch out of beta revert back to our API V1.

Open SidemenuDocs
Close Sidemenu


In this guide, you’ll learn how to get started with Telnyx Call Control within the Telnyx Portal. Just follow these simple steps:

  1. 1Sign up for a Telnyx Account.
  2. 2Create a Call Control Application to configure how you connect your calls.
  3. 3Buy or port a Phone Number (required for inbound calls).
  4. 4Assign your number to the Call Control Application.
  5. 5Create an Outbound Voice Profile to configure your outbound call settings and assign it to your Call Control Application.

Step 1: Sign Up for a Telnyx Mission Control Portal Accountstep-1--sign-up-for-a-telnyx-mission-control-portal-account

Head to Developers to sign up for your free Telnyx account. It’ll give you access to our Mission Control Portal where you can buy phone numbers, set up and manage Call Control Applications, and more.

Step 2: Create a Call Control Applicationstep-2--create-a-call-control-application

  • Select "Call Control"PORTAL on the left-hand navigation menu, click "+Add New App".
  • For testing purposes, you can set the webhook URL using an endpoint you create at https://hookbin.comTelnyx Developers.
Note Type Info

If you are interested in using TeXML, you can create a TeXML specific application herePORTAL.

Step 3: Buy a Phone Numberstep-3--buy-a-phone-number

You can search for, buy, and provision new numbers, or port existing numbers - all within the Numbers section of the Telnyx PortalPORTAL.

Simply click on "Numbers", then either "Search & Buy Numbers" or "Port Numbers" and follow the prompts.

You can also do this programmatically via our RESTful API. Check out our documentation for number searchingAPI and orderingAPI.

Step 4: Assign Your Phone Number to the Call Control Applicationstep-4--assign-your-phone-number-to-the-call-control-application

Once your number has been purchased or ported, assign it to the Call Control Application that you created in step 2. You can do this via the My NumbersPORTAL section of the Portal.

Docs Images (1)

Step 5: Create an Outbound Voice Profilestep-5--create-an-outbound-voice-profile

To use the Dial and Transfer commands, you must first create an Outbound Voice Profile and assign your Call Control Application to it.

Select "Outbound Voice Profiles"PORTAL on the left-hand navigation menu, click "+Add New Profile" and set up your profile name. Add the Call Control Application you just created above, the traffic type, the service plan, and your desired billing method.

You can also do this programmatically via our RESTful API. Check out our documentation for Outbound Voice ProfilesAPI.

That’s it. You're all set to start integrating Telnyx with your applications. After you setup your development environment you can learn how to send commands and receive webhooks.

Was this page helpful?was-this-page-helpful