---
title: "Send SMS"
method: POST
path: "/v1.0/message/sms/send"
tags: ["Communication"]
---

# Send SMS

`POST /v1.0/message/sms/send`

Sends an SMS to the specified lead from the caller's virtual number.

Notes:
- leadId and content are required.
- phoneNumber + phoneCode select a specific phone on the lead; when omitted, the lead's primary phone is used.
- Caller must have manage permission on the lead and must have an active virtual number.

## Headers

- `Authorization` string, required
- `Content-Type` string, required

## Request body

- SmsRequest — SMS request payload.
  - `phoneNumber` string — Recipient phone number
  - `phoneCode` string — Recipient phone code
  - `content` string, required — SMS content
  - `leadId` integer, required — Lead ID. When phoneNumber and phoneCode are not provided or no matching phone is found for the lead, the system will use the primary phone number of this lead.

## Response `200`

SMS delivered to the provider. Response contains the message ID and destination.

- SmsResponse
  - `messageId` string — The ID of the SMS message
  - `phoneNumber` string — Recipient phone number
  - `phoneCode` string — Recipient phone code

## Other responses

- `400` — Invalid parameters
- `401` — Missing or invalid authentication token.
- `500` — Internal server error.

---

[API](https://skmtc.net/lofty/apis/lofty-service-open-apis.md) · [All operations](https://skmtc.net/lofty/apis/lofty-service-open-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lofty/lofty-service-open-apis/revisions/23e640467118/schema)