Skip to main content
POST
/
v1
/
message
/
send
Send message
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"
}