SMS Service Usage
This sections illustrates how to use the SMS Service.
With this API you can send a new SMS.
The body of the request should have the following shape.
sender(required): the sender of the message. It can be one of the following:
- a phone number in E.164 format
- an alphanumeric sender ID
receiver(required): the destination phone number in E.164 format.
body(required): the text of the SMS you want to send.
The body of a single SMS can be up to 1600 characters long. If it's longer than that, the service will send the message as a segmented SMS and your Twilio account will be charged accordingly.
It follows an example of a valid request body.
"body": "Your SMS body"
If something goes wrong during the request, the response will have a
5xx status code and the following
"error": "Bad request",
"message": "Exception description"
A notable status code is 429, which means that you have reached the REST API concurrency limit of Twilio (more information here).
In case of successful response (status code
200), the body of the response has the following structure:
"dateEvent": "2021-08-13T12:53:52.959Z", // ISO format
"numSegments": "1", // Number of SMS messages it took to deliver the body of the message
"sid": "124354", // Unique identifier of the SMS
"status": "sent" // Status of the SMS