POST
/
message
/
{serviceId}
cURL
curl --request POST \
  --url https://api.belio.co.ke/message/{serviceId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "type": "SendToEach",
  "messages": [
    {
      "text": "<string>",
      "phone": "<string>"
    }
  ],
  "receiptRequest": {
    "correlator": "<string>",
    "callbackUrl": "<string>"
  }
}'
{
  "desc": {
    "requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "units": 123,
    "addresses": 123
  }
}
Refer to Authentication for information on how to obtain a Bearer token.
This endpoint requires the mobilize.sms.send.oneway API client authorization scope to send one way messages. You can set up scopes on the API Clients page.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
serviceId
string
required

Unique identifier for the messaging service

Body

application/json

Message details for sending to one or multiple recipients

Send message to a single recipient

Response

200
application/json

Message(s) sent successfully

The response is of type object.