Send Transactional SMS
Call this endpoint with a POST request to send an SMS with the provided details in the body.
Endpoint
| Method | URL | Parameters |
|---|---|---|
| POST | https://[Your URL]/api/2.0/production/sms/message | [Your URL] – Your Everlytic Install URL, e.g. live1.everlytic.net |
Request Body
{
"message": "SMS Content", "mobile_number" : "27823000123”
}
Properties
| Property | Description | Data type | Required |
|---|---|---|---|
| message | Content of the message to be sent. Maximum 459 characters. | string | Yes |
| mobile_number | The mobile number to be sent to. Only valid SA numbers allowed. | string | Yes |
Example Request
curl --location 'https://live0.everlytic.net/api/2.0/production/sms/message'
--data '{"message": "Hello world", "mobile_number" : "27823000123”}’
Response
Status codes
| Status | Explanation |
|---|---|
| 200 OK | SMS was sent successfully |
| 401 Unauthorized | Invalid or missing authorization credentials |
| 403 Forbidden | Mobile number provided is not a valid South African number. |
Properties
| Property | Description | Data type | Parameters |
|---|---|---|---|
| status | Status of response from API | enum (string) |
|
| message | Description of the response | string | |
| data | Array containing the ID assigned to this transaction. Only present if status is “success”. | JSON |
|
|
The ID assigned to this transaction. | string |
Example responses
SMS was sent successfully [200 OK]
{
"status": "success",
"message": "Your message has been sent.",
"data": {
"id": “d1gab71d-3a20-4833-a6f1-b934686e0576"
}
}
Missing/Invalid credentials [401 Unauthorized]
"Invalid credentials."
Invalid mobile number [403 Forbidden]
{
"status": "error",
"message": "Unable to send transaction. Only valid SA numbers are allowed"
}