---
title: "Sends a SMS message from a phone number that belongs to the authenticated account."
method: POST
path: "/sms"
tags: ["Sms"]
---

# Sends a SMS message from a phone number that belongs to the authenticated account.

`POST /sms`

## Query parameters

- `api-version` string, required

## Request body

- SendMessageRequest — Represents the properties of a send message request.
  - `from` string, required — The sender's phone number in E.164 format that is owned by the authenticated account.
  - `smsRecipients` SmsRecipient[], required — The recipient's phone number in E.164 format. In this version, a minimum of 1 and upto 100 recipients in the list are supported.
    - `to` string, required — The recipient's phone number in E.164 format.
    - `repeatabilityRequestId` string — If specified, the client directs that the request is repeatable; that is, the client can make the request multiple times with the same Repeatability-Request-ID and get back an appropriate response without the server executing the request multiple times. The value of the Repeatability-Request-ID is an opaque string representing a client-generated, 36-character hexadecimal case-insensitive encoding of a UUID (GUID), identifier for the request.
    - `repeatabilityFirstSent` string — MUST be sent by clients to specify that a request is repeatable. Repeatability-First-Sent is used to specify the date and time at which the request was first created.eg- Tue, 26 Mar 2019 16:06:51 GMT
  - `message` string, required — The contents of the message that will be sent to the recipient. The allowable content is defined by RFC 5724.
  - `smsSendOptions` SmsSendOptions — Optional configuration for sending SMS messages.
    - `enableDeliveryReport` boolean, required — Enable this flag to receive a delivery report for this message on the Azure Resource EventGrid.
    - `tag` string — Use this field to provide metadata that will then be sent back in the corresponding Delivery Report.
    - `deliveryReportTimeoutInSeconds` integer — Time to wait for a delivery report. After this time a delivery report with timeout error code is generated.
    - `messagingConnect` MessagingConnectOptions — Defines optional parameters for connecting with the Messaging Connect Partner to deliver SMS.
      - `partner` string, required — Specifies the partner name for message delivery.
      - `partnerParams` object, required — Partner-specific parameters as key-value pairs. Must contain at least one parameter required by the messaging connect partner (e.g., apiKey, servicePlanId, authToken, etc.).

## Response `202`

Accepted

- SmsSendResponse — Response for a successful or multi status send Sms request.
  - `value` SmsSendResponseItem[], required
    - `to` string, required — The recipient's phone number in E.164 format.
    - `messageId` string — The identifier of the outgoing Sms message. Only present if message processed.
    - `httpStatusCode` integer, required — HTTP Status code.
    - `repeatabilityResult` 'accepted' | 'rejected' — The result of a repeatable request with one of the case-insensitive values accepted or rejected.
    - `successful` boolean, required — Indicates if the message is processed successfully or not.
    - `errorMessage` string — Optional error message in case of 4xx/5xx/repeatable errors.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized

## Changes

- **2026-07-13** `a402be972bb5` — 2 info
  - added the non-success response with the status `400`
  - added the non-success response with the status `401`
- **2026-07-13** `adf0e962f5e5` — 1 breaking, 1 info
  - removed the success response with the status `200`
  - added the success response with the status `202`

[Change history](https://skmtc.dev/azure/apis/communication-sms/changes/sms/post.md)

---

[API](https://skmtc.dev/azure/apis/communication-sms.md) · [All operations](https://skmtc.dev/azure/apis/communication-sms/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/communication-sms/revisions/a402be972bb5/schema)