---
title: "Send an SMS to a customer"
method: POST
path: "/v1/sms/messages"
tags: ["SMS messages"]
---

# Send an SMS to a customer

`POST /v1/sms/messages`

Sends an SMS to the customer's verified mobile number. You can use this endpoint to send informational texts to your customers, such as notifications about transactions (e.g., amounts debited or credited or request for purchases) or reminders (e.g., minimum amount due for credit cards, loans, etc.) or other informational messages (e.g., account statement generated, end of month account balance, etc.).<br> **Important:** You cannot use this endpoint for use cases that require Strong Customer Authentication (SCA) (i.e., confirmation via OTP). In such cases, please use the dedicated [SMS challenges endpoints](https://docs.solarisgroup.com/api-reference/onboarding/device-management/#tag/SMS-challenges).

## Request body

- object
  - `person_id` string, required — The `person_id` of the customer to whom the SMS should be sent.
  - `text` string, required — The text of the SMS to be sent. A maximum of 160 characters.
  - `purpose` string, required — The purpose of the SMS.
  - `idempotency_key` string, uuid, required — A randomly generated UUID which the server uses to recognize subsequent retries of the same request.

## Response `202`

Accepted

- object
  - `id` string — A unique ID of the message that has been sent.
  - `message` string — A short description about the request status.

## Other responses

- `400` — Bad Request
- `403` — No access
- `409` — Conflict
- `429` — Too Many Requests
- `500` — Internal server error.

---

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