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

Open SidemenuDocs
Docs
Close Sidemenu

Quickstartquickstart

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 an application to configure how you connect your calls.
  3. 3Buy or port a phone number to receive inbound calls, and assign this number to your new application.
  4. 4Create an outbound voice profile to make outbound calls, and assign your application to this new profile.

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

Head to telnyx.com/sign-upTelnyx 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 or TeXML applicationstep-2--create-a-call-control-or-texml-application

TeXML is the quickest way to build programmable voice applications in minutes using a simple XML data structure. Learn more, and build a basic text-to-speech app in just 5 lines of code, with our tutorial.

  • Select "Call Control"PORTAL on the left-hand navigation menu
    • Click Add New App to create an application to control calls via API.
    • Click TeXML Applications in the top navigation bar, then click Add New TeXML App to create an application to control calls using our simple XML data structure.
  • Call Control and TeXML applications work by sending and receiving webhooks. For testing purposes, you can set the webhook URL to an endpoint you create at https://hookbin.comTelnyx Developers.
  • Don't worry about the other settings for now - you can always come back and edit these later when following our other tutorials. Scroll down and hit Save to finish creating your application.

Step 3: Buy a phone number and assign it to the applicationstep-3--buy-a-phone-number-and-assign-it-to-the-application

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, orderingAPI, and assigning numbers to connections or applicationsAPI.

You can assign your new number to an application at checkout. Simply select your application in the Assign Connection dropdown.

Assigning your Number to a Connection or Application at Checkout

If you already own a number or have ported a number to Telnyx, you can also assign it to your new application from the My Numbers view in the portal.

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

To build applications that make outbound calls, you must first create an Outbound Voice Profile and assign your 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 application you just created above, specify at least one destination to allow for outbound calls, and hit Save to finish creating your profile.

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.

Where to next?where-to-next-

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