Skip to main content
Version: 10.9.x

SMS Service Usage

This sections illustrates how to use the SMS Service.

POST /send​

With this API you can send a new SMS.

Body​

The body of the request should have the following shape.

  • sender (required): the sender of the message. It can be one of the following:

  • receiver (required): the destination phone number in E.164 format.

  • body (required): the text of the SMS you want to send.

caution

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.

{
  "sender": "+15017122661",
  "receiver": "+15558675310",
  "body": "Your SMS body"
}

Response​

Exceptions​

If something goes wrong during the request, the response will have a 4xx or 5xx status code and the following payload:

{
  "statusCode": "400",
  "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).

Success​

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
}