This article gives an overview of how you can start sending Alphanumeric… See Telnyx guidance and requirements.
Make sure you've configured your account, such as purchasing a number, creating a messaging profile, and associating that messaging profile with that number. More details about Sending SMS using API V1 can be reviewed here. POSTMAN is a RESTful HTTP client and can be downloaded from here.
Make sure to also check out our Alphanumeric capabilities in this article.
And for specific error codes click here:
![]()
What is the Alphanumeric Sender ID?
Alphanumeric Sender ID allows you to set your company name or brand as the Sender ID when sending one-way SMS messages to international destinations.
Alphanumeric Sender IDs must be between 3 and up to 11 characters in length. Accepted characters include both upper- and lowercase ASCII letters, the digits 0 through 9, and space: A-Z, a-z, 0-9. They may not be only numbers.
Alphanumeric Sender ID can be set dynamically on the POST request to our API when sending an SMS. You just need to set a valid alphanumeric ID in the FROM field and we will use that.
Consider that you need to have your account verified to Level 2 in order to use this feature. At this time, alphanumeric is not supported by the carriers in the US or Canada.
![]()
Sending Alphanumeric SMS Via API V1
At this stage, you are ready to send SMS.
- Open up, Postman. "POST" to "https://sms.telnyx.com/messages"
- In "Headers", set your "x-profile-secret" to the secret under your Messaging Profile.
- In the "Body", you can paste in the following:
{
"from": "Alphanumeric_id",
"to": "+1[intended recipient]",
"body": "Hello World"
}
Video demo showing sending Alphanumeric SMS via Postman
Kudos! now you know how to send Alphanumeric SMS using API V1.
![]()
Sending Alphanumeric SMS Via API V2
You can send one way alphanumeric messages via our API V2.
Example:
curl --location --request POST 'https://api.telnyx.com/v2/messages' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer KEYXXX' \
--data-raw '{
"from": "MyCompany",
"to": "+destination_number",
"messaging_profile_id": "abcdefghi-35bc-4c53-aa60-515de9de707c",
"text": "Hello World!",
"webhook_url": "for real time updates"
}'
![]()