---
title: "Send SMS message"
method: POST
path: "/api/v1/message/sms"
tags: ["Messages"]
---

# Send SMS message

`POST /api/v1/message/sms`

The method is used for sending an SMS message to a contact. A new contact is created if no contact with such phone number exists.

## Request body

- OutgoingSMS
  - `from` string, required — Sender name. Enter one of the valid sender names
  - `text` string, required — Message text
  - `phoneNumbers` string[] — <b>Required parameter</b>, if &quot;groupId&quot; is not specified.
  - `tags` string[] — The list of tags to be assigned to a message.
  - `groupId` integer — <b>Required parameter</b>, if &quot;phoneNumbers&quot; is not specified. Segment ID to which the message will be sent
  - `externalRequestId` string — External request ID. It is the same for all the recipients.
  - `subscriptionsKeys` string[]
  - `trackUrls` boolean — The parameter determines whether to track links in a message or not. The default value is ‘false’.

## Response `200`

---

[API](https://skmtc.net/esputnik/apis/esputnik-com.md) · [All operations](https://skmtc.net/esputnik/apis/esputnik-com/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/esputnik/esputnik-com/versions/1c4afd7ba72a/schema)