> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sequenzy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Send Test SMS

> Send a test SMS to a phone number

# Send Test SMS

Sends a real test text message to any phone number. 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 - check [Get SMS Settings](/api-reference/sms/settings) first.

## Request

<ParamField body="to" type="string" required>
  Destination phone number in international E.164 format, e.g. `+15550100123`.
</ParamField>

<ParamField body="text" type="string">
  Plain-text message body. Provide `text` or `blocks`, not both.
</ParamField>

<ParamField body="imageUrls" type="array">
  Up to 2 publicly reachable image URLs sent as MMS media (US/CA destinations only). Only valid together with `text`.
</ParamField>

<ParamField body="blocks" type="array">
  SMS content blocks (text + image subset). Provide `text` or `blocks`, not both.
</ParamField>

```bash theme={null}
curl -X POST "https://api.sequenzy.com/api/v1/sms/test" \
  -H "Authorization: Bearer seq_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+15550100123",
    "text": "Test from Sequenzy"
  }'
```

## Responses

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "smsSendId": "sms_abc123",
    "toPhone": "+15550100123",
    "message": "Test SMS queued to +15550100123. Test sends bypass quiet hours, charge credits, and are excluded from step stats."
  }
  ```

  ```json 400 theme={null}
  {
    "error": "Enter a valid phone number in international format, e.g. +15550100123"
  }
  ```

  ```json 401 theme={null}
  {
    "error": "Invalid API key"
  }
  ```

  ```json 403 theme={null}
  {
    "error": "The SMS add-on is not enabled for this company. Enable it in Settings > SMS."
  }
  ```

  ```json 429 theme={null}
  {
    "error": "Test send limit reached (5 per hour). Try again later."
  }
  ```

  ```json 500 theme={null}
  {
    "error": "Failed to send test SMS"
  }
  ```
</ResponseExample>