Agent Number

POST /sms/send

Send an SMS from your assigned number

Description

Outbound SMS dispatched from the number bound to the bearer token. Returns the carrier `message_id` once the message is queued for delivery. Long messages are concatenated client-side — there is no built-in segmentation.

Authentication

Bearer required. Send Authorization: Bearer <token>.

Code samples

Pick your runtime. Every sample is in the page source — switching tabs is for your eyes.

curl https://agentnumber.really.com/sms/send \
  --request POST \
  --header 'Authorization: Bearer <your-token>' \
  --header 'content-type: application/json' \
  --data '{
  "to": "+15555550199",
  "body": "Hello from my agent."
}'

Request body

FieldTypeDescription
to required string Destination phone number in E.164 format (`+1...`).
Example: +15555550199
body required string Message text. UTF-8.
Example: Hello from my agent.

Example body

{
  "to": "+15555550199",
  "body": "Hello from my agent."
}

Responses

200 Message queued for delivery.

{
  "message_id": "msg_example_0000000000000000000000",
  "status": "queued"
}

400 Body missing `to` or `body` field.

{
  "error": "invalid_request",
  "message": "missing required fields: to, body"
}

401 Missing, invalid, revoked, or expired bearer token.

{
  "error": "unauthorized",
  "message": "invalid, revoked, or expired token"
}

502 Upstream phone-node returned an error. Usually transient — retry.

{
  "error": "phone_node_error",
  "message": "Mac returned 503"
}