To use Unifonic REST API, you will need a Unifonic account, an application ID (AppSid), and a registered sender.

Method: POST

Unifonic API only supports JSON format. All requests must use the Content-type header set to application/json.

In the API request, you need to include the following parameters:

ParameterDecriptionExample Value
AppSidAuthentication string that uniquely identifies your application.6v253153s1g7831s5
SenderIDThe SenderID identifies who has sent the SMS message, typically a brand name; in case of not adding this parameter, the system will use the default SenderIDSender
RecipientDestination mobile number, mobile numbers must be in international format without 00 or + Example: (966507679351)966505980169
BodyMessage body. Supports both English and Unicodes characters e.g. Arabic.Hello world!
Unique identifier value that is attached to requests and messages.

API Request Example

curl --location --request POST '' \
--header 'Accept: application/json' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'AppSid=axuN0U7QlmqV1234goK0mZFgdzG816p' \
--data-urlencode 'SenderID=UNISMS' \
--data-urlencode 'Body=Hello there' \
--data-urlencode 'Recipient=966507679351'

API response example

    "success": true,
    "message": "",
    "errorCode": "ER-00",
    "data": {
        "MessageID": 42000348806924,
        "CorrelationID": "CorrelationID",
        "Status": "Sent",
        "NumberOfUnits": 0,
        "Cost": 0,
        "Balance": 0,
        "Recipient": "971507679351",
        "TimeCreated": "2022-09-06 14:06:25.979",
        "CurrencyCode": ""
    "success": false,
    "message": "Dest num is too short",
    "errorCode": "ER-04",
    "data": {}