Sends an SMS or MMS message to a single recipient. The sender number (from) must be an active number assigned to your account. For SMS, provide a body (max 640 characters). For MMS, provide a mediaUrl pointing to a publicly accessible media file; the media is downloaded, validated, and attached to the message. You may include both body and mediaUrl for MMS with text. An optional idempotencyKey prevents duplicate sends — if a message with the same key was already successfully sent within the past 48 hours, the original response is returned. Failed sends do not consume the idempotency key and can be safely retried.
Content compliance: Message content is validated against messaging compliance rules (SHAFT, phishing, etc.). Messages that violate these rules are rejected with error code 33019.
Rate limit: 60 requests per 60-second window. Every response includes X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset headers. When the limit is exceeded, a 429 response is returned with a Retry-After header.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||