Send your first SMS
One bearer-gated POST. The carrier message id comes back once it's queued; delivery confirmation is asynchronous.
Prereqs
- You have a bearer token (see Subscribe).
- The destination is in E.164 format (
+1...).
Send
curl -X POST https://agentnumber.really.com/sms/send \
-H "authorization: Bearer <token>" \
-H "content-type: application/json" \
-d '{"to": "+15555550199", "body": "Hello from my agent."}'
# → 200
# {"message_id": "msg_...", "status": "queued"}Read it back from history
Pull the row you just wrote (or any past row) from
/sms/messages — read-only, doesn't
mutate delivered_at:
curl "https://agentnumber.really.com/sms/messages?direction=sent&limit=10" \
-H "authorization: Bearer <token>"Common errors
| Status | Meaning |
|---|---|
400 | Body is missing to or body |
401 | Bearer missing, invalid, revoked, or expired |
502 | Hardware temporarily upstream-unreachable. Retry. |
Where to go next
- Receive inbound SMS — the long-poll counterpart
- Send reference — full schema + every status code