---
title: "Send A2P SMS"
method: POST
path: "/restapi/v1.0/account/{accountId}/a2p-sms/batches"
tags: ["High Volume SMS"]
---

# Send A2P SMS

`POST /restapi/v1.0/account/{accountId}/a2p-sms/batches`

Allows to send high volume of A2P (Application-to-Person) SMS messages
(in message batches). Only phone number with the `A2PSmsSender` feature can
be used as a sender.

## Path parameters

- `accountId` string, required

## Request body

- MessageBatchCreateRequest — Batch of A2P SMS messages. This object provides specification to send message(s) to many recipients. It contains top-level attributes, such as `text` which apply to all `messages`. In addition to that, it is possible to override this attribute for each message. This way a single API call may be used to send individual messages to many recipients.
  - `from` string, required — Sender's phone number in [E.164](https://www.itu.int/rec/T-REC-E.164-201011-I) format.
  - `text` string — Text to send to `messages.to` phone numbers. Can be overridden on a per-message basis
  - `messages` MessageCreateRequest[], required — Individual messages
    - `to` string[], required — List of phone numbers in [E.164](https://www.itu.int/rec/T-REC-E.164-201011-I) format, recipients of this message. Currently only one number is supported
    - `text` string — Text to send, maximum number of characters is 1000

## Response `201`

Message batch created

- MessageBatchResponse — Batch of A2P SMS messages. This object provides a specification to send message(s) to many recipients. It contains top-level attributes which apply to all messages. In addition to that, it is possible to override this attribute for each message. This way a single API call may be used to send individual messages to many recipients
  - `id` string — Unique identifier of the message batch
  - `from` string — Phone number in [E.164](https://www.itu.int/rec/T-REC-E.164-201011-I) format from which the messages are going to be sent
  - `batchSize` integer — Total number of messages in the accepted batch
  - `processedCount` integer — Total number of messages currently processed in the batch
  - `lastModifiedTime` string, date-time — The last time the batch was processed.
  - `status` 'Processing' | 'Completed' — Current status of a message batch
  - `creationTime` string, date-time — The time at which the batch was created
  - `rejected` RejectedRecipientResponseResource[] — The list of rejected/invalid recipients
    - `index` integer — The index of the messages list in the send batch request where the invalid recipient was found
    - `to` string[] — The invalid recipient number as found in the request
    - `errorCode` string — The error code
    - `description` string — The description of the error
  - `cost` number, double — The estimated batch cost for completed batch. Calculated after batch processing is completed.

## Other responses

- `400` — Validation Failed, Invalid Request
- `401` — Unauthorized error
- `500` — Internal server error

---

[API](https://skmtc.net/ringcentral/apis/ringcentral-api.md) · [All operations](https://skmtc.net/ringcentral/apis/ringcentral-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringcentral/ringcentral-api/revisions/8d602198ec97/schema)