RinghouseAPI reference
Get started

Messages

Send a message

Send one message.

POST/v1/messages

Needs the messages:write scope.

Body parameters

fromstringrequired
The number to send from: its id, or the number itself in E.164.
textstringrequired
tostringrequired
One recipient in E.164.

Returns

The message, as accepted. A failed call answers with an error instead.

idstring
createdAtstring
directionstring
inbound | outbound.
fromstring
mediaMediaResource[]
numberIdstring
statusstring
queued | sent | delivered | undelivered | failed | received.
textstring
tostring
curl -X POST https://api.ringhouse.ai/v1/messages \
  -H "Authorization: Bearer rh_live_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "<string>",
    "text": "<string>",
    "to": "<string>"
  }'
{
  "id": "8c1d4e7a-5b2f-4a90-9e1c-3f7d2b6a1c08",
  "createdAt": "2026-09-25T14:02:11Z",
  "direction": "inbound",
  "from": "+447700900123",
  "media": [
    {
      "contentType": "image/jpeg",
      "url": "https://files.ringhouse.ai/media/8c1d4e7a/photo.jpg"
    }
  ],
  "numberId": "e41b09c2-77d3-4c5e-b0a8-9d2f61c4e3a7",
  "status": "completed",
  "text": "Is my table ready for eight?",
  "to": "+441134960000"
}