---
title: "Send a test SMS"
method: POST
path: "/sms/test"
tags: ["SMS"]
---

# Send a test SMS

`POST /sms/test`

Sends a real test text message. Test sends charge credits, bypass quiet hours, are excluded from step stats, and are limited to 5 per company per hour. Requires the SMS add-on with a verified number.

## Request body

- object
  - `to` string, required — Destination phone number in international E.164 format.
  - `text` string — Plain-text message body. Provide text or blocks, not both.
  - `imageUrls` string[] — Up to 2 publicly reachable image URLs sent as MMS media (US/CA only).
  - `blocks` object[] — SMS content blocks (text + image subset). Provide text or blocks, not both.

## Response `200`

Test SMS queued successfully

- object
  - `success` boolean
  - `smsSendId` string
  - `toPhone` string
  - `message` string

## Other responses

- `400` — Validation error
- `401` — Unauthorized
- `403` — SMS add-on not enabled, plan not eligible, or number not verified
- `429` — Test send limit reached
- `500` — Failed to send test SMS

---

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