POST
/
v1
/
message
/
send
curl --request POST \
  --url https://api.sendo.dev/v1/message/send \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "campaign": "<string>",
  "body": "<string>",
  "to": "<string>",
  "from": "<string>",
  "mediaUrls": {},
  "metadata": {}
}'
{
  "success": true,
  "id": "f7d258bd-f697-4840-b8a6-165707e12345"
}
Before sending messages, you must create a campaign. Once approved, use the campaign ID on your dashboard when sending API calls.

​
Body

​
campaign
string
required

The ID of the campaign you are sending from.

​
body
string
required

Body of the text message to send (max 1500 characters).

​
to
string
required

Phone number of the recipient. Must be format.

​
from
string

Phone number to send from (optional). Must be format.

​
mediaUrls
[string]

Array of media file URLs to send as MMS. Guide here.

​
metadata
object

Object with custom string key-value pairs. Guide here.

​
Response

​
success
boolean
required

Whether the message was sent successfully.

​
id
string

The ID of the message that was sent.

​
error
string

Error message if the request fails.

​
Errors

If the request fails, it will return an HTTP error status code and an error field in the response body with details. Full list of status codes here.

Click here to read our full message deliverability guide
{
  "success": true,
  "id": "f7d258bd-f697-4840-b8a6-165707e12345"
}