Send an outbound SMS message | Voice Platform

Send one outbound SMS synchronously to the configured provider. A 202 response confirms provider queue acceptance, not carrier handoff or recipient delivery.

Authentication

AuthorizationBearer

Application auth. Send Authorization: Bearer <app_uuid>:<api_key> using any active key in the app’s collection. See Authentication for details.

Application auth. Send `Authorization: Bearer <app_uuid>:<api_key>` using any active key in the app's collection. See [Authentication](https://voice-platform.docs.buildwithfern.com/api/authentication) for details.

Request

This endpoint expects an object.

channelenumRequired

Allowed values:

contentobjectRequired

fromstringRequired

tostringRequiredformat: "^\+[1-9]\d{1,14}$"

Response

The provider accepted the SMS into its queue.

channelenum

created_atdatetime

directionenum

message_uuidstringformat: "^msg_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"

statusenum

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

409

Conflict Error

413

Content Too Large Error

415

Unsupported Media Type Error

422

Unprocessable Entity Error

429

Too Many Requests Error

500

Internal Server Error

503

Service Unavailable Error

$	curl -X POST https://api.telekesher.dev/v1/messages \
>	-H "Idempotency-Key: Idempotency-Key" \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"channel": "sms",
>	"content": {
>	"text": "string",
>	"type": "text"
>	},
>	"from": "string",
>	"to": "string"
>	}'

1	{
2	"channel": "sms",
3	"created_at": "2026-08-28T12:00:00.000Z",
4	"direction": "outbound",
5	"message_uuid": "msg_550e8400-e29b-41d4-a716-446655440000",
6	"status": "queued"
7	}

Authentication

Headers

Request

Response

Errors