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" }