Messages API

Guides: Send a message · Receive a message.

Endpoint	Purpose
POST /api/v1/messages	Send an SMS from a number you own
GET /api/v1/messages	List messages (direction, limit)

POST /api/v1/messages

Body: to (required, E.164), body (required, ≤1600 chars), from or from_number_id (optional when you own one number), idempotency_key.

Returns 201 {id, status, provider_sid, to, from} and emits message.sent.

Inbound

Inbound SMS/WhatsApp are answered by the owning agent and emitted as message.received events — consume them via webhooks or events.