This article gives an overview of how you can get started with Telnyx SMS… 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 for sending SMS using POSTMAN here and for specific error codes here. POSTMAN is a RESTful HTTP client and can be downloaded from here: https://www.postman.com/downloads/
![]()
Sending 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": "+1[your messaging-enabled number]",
"to": "+1[intended recipient]",
"body": "Hello World"
}
Video demo showing sending SMS via Postman using API v1
Yay! You have sent your first SMS using API V1.
![]()
Sending SMS Via API V2
Open up, Postman. "POST" to "https://api.telnyx.com/v2/messages"
Now you need to generate API V2 secret Key
For using API V2 to send out SMS, you need to generate V2 key here in the API Keys Section

- Click on create API key on top

- This will be the new API v2 key that will be used while sending SMS

- In the Postman "Headers", set your "Authorization" to the API v2 secret key and the Key should be preceded with "Bearer".

- In the "Body", you can paste in the following:
{
"from": "+1[your messaging-enabled number]",
"to": "+1[intended recipient]",
"text": "Hello World"
}
Video demo showing sending SMS via Postman using API V2
Kudos! now you know how to send SMS using API V2
![]()