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

Open SidemenuDocs
Close Sidemenu

Mission Control Portal Set Upmission-control-portal-set-up

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

  1. 1Sign up for a Telnyx account.
  2. 2Buy an SMS-capable phone number.
  3. 3Create a messaging profile to configure how you send and receive messages on your phone number.
  4. 4Assign your phone number to your messaging profile.

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 numbers, set up and manage messaging profiles, and more.

A free credit will be automatically applied to your account upon signup. To enter a promo code, click on My Account in the top-right portal dropdown.

Step 2: Buy an SMS-capable Phone Numberstep-2--buy-an-sms-capable-phone-number

To use the Messaging API, you’ll need an SMS-capable phone number purchased from, or ported into, the Telnyx platform. If purchasing a new number, select the SMS number feature when searching. In general, numbers that are ported in will be messaging-capable.

Within the Numbers section of the Telnyx PortalPORTAL, you can search for, buy and provision new numbers – or port existing numbers.

  1. 1Click on Numbers in the navigation menu on the left-hand side of the portal.
  2. 2Click on the Search & Buy Numbers tab and enter your city, country or rate center.
  3. 3Select the number features you want. You can choose “Any” or check the individual boxes to select specific features: Voice, Fax, SMS, MMS.
  4. 4Click Search.
  5. 5Find the number(s) you want to purchase from the list of results and then click +Add to Cart.
  6. 6Click on your Cart in the top-right corner of the portal. The number(s) you selected should now be visible in your Cart.
  7. 7To purchase, click Place Order*. Your number(s) should now be visible in both the “My Numbers” and “Orders” tabs.


  • You’ll need to ensure that you have enough available credit to make the purchase. To add credit to your account, click the + button to the left of your balance in the top-right corner of the portal.
  • Make sure

You can also add/buy numbers programmatically via our RESTful API. Check out our documentation for number searchingAPI and orderingAPI.

Step 3: Create a Messaging Profilestep-3--create-a-messaging-profile

Messaging Profiles are the simplest way for you to configure your inbound and outbound messaging settings. An SMS-capable phone number is SMS-enabled by assigning it to a Messaging Profile.

Configure your profile to send and receive SMS messages.

  1. 1Click on MessagingPORTAL in the navigation menu on the left-hand side of the portal.
  2. 2Click Add new profile.
  3. 3Enter a name for your Messaging Profile. Configure any other desired settings, such as webhook URLs.

    Note: Ensure the profile is using API V2

  4. 4Click Save to create the profile.

That’s it. Your Messaging Profile has now been created.

You can also do this programmatically via our RESTful API. Check out our documentation for creating a Messaging Profile and assigning it to a number.

Alphanumeric Sender ID: As an alternative to sending SMS from a phone number, you can use an alphanumeric sender ID. Messages sent in this manner are outbound only; it is not possible to receive replies. To use an alphanumeric sender, simply put it in the from field when you submit a send request.

Step 4: Assign Your Phone Number to Your Messaging Profilestep-4--assign-your-phone-number-to-your-messaging-profile

Once you’ve created a messaging profile, you’ll need to add your number to that profile:

  1. 1Click on My NumbersPORTAL in the navigation menu on the left-hand side of the portal.
  2. 2Click the My Numbers tab and find the number you want to add to your messaging profile.
  3. 3For your number, click on the “Select profile to send messages” box in the “Messaging Profile” column.
  4. 4In the window that opens, select your messaging profile from the dropdown menu under “SMS Messaging”.
  5. 5Click Save Changes.
  6. 6The changes may change your monthly recurring charge (MRC) for the number. Click Accept if you approve the change.

Your messaging profile should now show an updated count under “Numbers Connected” on your Messaging Profiles page. If the count has not changed, refresh your page to update.

You can also do this programmatically via our RESTful API. Check out our documentation for assigning a number to a Messaging Profile.

That’s it, you’re all set to start messaging. Next, learn how to set up your development environment.

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