Messaging in Mission Control

Set up your Telnyx Mission Control for messaging. Step-by-step guide inside!

David avatar
Written by David
Updated over a week ago

This article lists the requirements needed to set up your Telnyx Mission Control Portal account so that it's ready to be configured with your messaging system.

Telnyx Mission Control for Messaging

We recommend first reading on our Acceptable Use Policy for Messaging.

If you would prefer a guided setup and know some programming concepts check out our messaging "Learn & Build" after steps 1 & 2.

Let's get you set up!, you will need:

In order to assign a connection/messaging profile on a DID or a connection on an outbound voice profile, you'll need to be Level 1 verified. More information on account verification can be found here.

You will need to add a payment method to your account in order to top up your balance. This will be necessary to purchase numbers, send messages, make/receive calls etc.

Further details on how to add a payment method can be found in our Billing support article.

3. Messaging Profile Setup

A messaging profile is a record that contains all the basic settings for your messages. Telnyx's messaging features are completely programmatic, as such you will need a webhook URL in order to receive inbound messages and track outbound messages. You can find how to create a messaging profile here.

4. DIDs

A DID (or TN, telephone number) is required in order to send and receive messages. There are several types of numbers and requirements for each:

  1. Regular number (a.k.a. 10-Digit Long Code): A regular number, such as your cellphone, including it's country code: +1 234 567 8910, +52 2345 1232, etc.

  2. Toll free number: A national number that allows caller fees to be passed on to the receiver (except for messaging).

  3. Short code: An special type of number, you have probably received 2FA codes on your cellphone from these.

Numbers also need to explicitly be SMS and/or MMS enabled. Each of them has different requirements and pricing depending on their locations. Please note that if you acquire a number without SMS capabilities we will not be able to add them further on.

Alternatively you can port a number into Telnyx, learn how here.

Once you have added a DID on your account, you'll have to assign the messaging profile via the numbers main page or the number configuration page.


If you can't assign a messaging profile and you see the column showing Not SMS Capable this is likely because the number you have acquired is not capable of sending or receiving messages. Please make sure when searching and purchasing numbers that the messaging features icon shows SMS Available as seen in this picture.

Search and buy numbers section.

If you come across the error: "Could not enable messaging on the number." when assigning a messaging profile to a number that is SMS capable, this may be related to the underlying provisioning with the central authority that handles the carrier NetNumber ID routing updates across the industry. If this error persists, please contact our support team so they can assist you further.

More details on our number search feature can be found here.

  1. Determine your type of traffic.

    Messaging is categorized in 2 types, A2P or Application-to-Person and P2P or Person-to-Person, more information here.

    If your traffic is A2P, please check on the local regulations for messaging.

    In the US and Canada, we strongly recommend optionally registering for 10DLC (soon mandatory) or mandatory registering Toll-Free Messaging, for these there might be additional lead time of up to 4 weeks or more depending on your use case and required documents.

    Check these articles for more information: 10DLC - Toll-Free messaging.

  2. Happy sending!

We recommend that you also check out these related articles

If you wish to increase your default sending rate, you will first need to obtain Level 2 Verification.

  • Check here for more information on purchasing TF and 10-digit numbers.

  • Check here for country specific guidelines for SMS.

  • Check here for information on Short Code.

  • If you are looking for SMPP instead, check here.

  • Check here for Alphanumeric sending (only available outside the US and Canada)

As always! Feel free to search our knowledge base or reach out to us via email, chat or telephone if you need additional assistance and/or have other questions.

Did this answer your question?