Messaging API
The Messaging API lets you send and receive SMS, MMS, and chat messages programmatically.
Endpoints
| Method | Endpoint | Description |
|---|---|---|
POST | /v1/messages | Send a message |
GET | /v1/messages | List messages |
GET | /v1/messages/{sid} | Retrieve a message |
DELETE | /v1/messages/{sid} | Delete a message |
Send a message
curl -X POST https://api.vetrol.io/v1/messages \
-u "$VETROL_ACCOUNT_SID:$VETROL_AUTH_TOKEN" \
-d "To=+1234567890" \
-d "From=+0987654321" \
-d "Body=Hello!"
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
to | string | Yes | Recipient phone number (E.164 format) |
from | string | Yes | Sender phone number |
body | string | Yes (unless media_url) | Message text |
media_url | string | No | URL of media to attach (MMS) |
Response
{
"sid": "MSxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"status": "queued",
"to": "+1234567890",
"from": "+0987654321",
"body": "Hello!",
"num_segments": 1,
"price": null,
"price_unit": "USD",
"created_at": "2026-03-13T17:00:00Z",
"updated_at": "2026-03-13T17:00:00Z"
}
Message statuses
| Status | Description |
|---|---|
queued | Message is queued for sending |
sending | Message is being dispatched |
sent | Message has been sent to the carrier |
delivered | Carrier confirmed delivery |
undelivered | Delivery failed |
failed | Message could not be sent |