Messages API

Deliver an incoming SMS from your platform to the correct user's inbox.

POST https://vchats.site/api/v1/messages/

Request body

Field	Type	Required	Description
destination	string	Yes	E.164 phone number e.g. `+15550019872`
body	string	Yes	The SMS text content
external_message_id	string	No	Your platform's message ID for idempotency (recommended)

Example

curl

curl -X POST https://vchats.site/api/v1/messages/ \
  -H "Authorization: Bearer vn_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "destination": "+15550019872",
    "body": "Your code is 847291",
    "external_message_id": "twilio_msg_abc123"
  }'

Response

201 Created

{
  "id": 42,
  "status": "delivered",
  "received_at": "2026-09-30T19:08:12.445Z"
}