Send SMS

Endpoint:

POST https://api.automas.sms.com/sms/send

Required Parameters:

• api_key (Required) — Your personal authentication key.
• to (Required) — One or multiple recipient numbers separated by commas. Use 8801XXXXXXXXX format.
• message (Required) — The actual SMS content.

Optional Parameters:

• sender_id — Approved sender ID (for masking SMS).
• schedule_time — Schedule the SMS in YYYY-MM-DD HH:MM:SS format.
• campaign_id — For campaign tracking.

Example Request:

        GET https://api.automas.sms.com/sms/send?api_key=YOUR_API_KEY
            &to=8801700000000,8801800000000
            &message=Hello+from+Automas
            &sender_id=AUTOMAS
            &schedule_time=2025-10-15 12:30:00
                                    

Example Response:

        {
          "error": 0,
          "message": "SMS request accepted",
          "data": {
            "request_id": "6789012345"
          }
        }
                                    

Delivery Report

Endpoint:

GET https://api.automas.sms.com/sms/report/{request_id}

Parameters:

• api_key (Required)
• {request_id} is returned when sending SMS.

Example Response:

        {
          "error": 0,
          "message": "Success",
          "data": {
            "request_id": "6789012345",
            "status": "Delivered",
            "recipients": [
              {
                "number": "8801700000000",
                "charge": "0.25",
                "status": "Delivered"
              },
              {
                "number": "8801800000000",
                "charge": "0.25",
                "status": "Pending"
              }
            ]
          }
        }
                                    

Check Balance

Endpoint:

GET https://api.automas.sms.com/user/balance

Parameters:

• api_key (Required)

Example Response:

        {
          "error": 0,
          "message": "Success",
          "data": {
            "balance": "245.50"
          }
        }
                                    

Error Codes

Possible error responses from the API:

• 400 — Bad request (missing parameter)
• 401 — Unauthorized (invalid API key)
• 403 — Access forbidden
• 404 — Resource not found
• 429 — Too many requests (rate limit exceeded)
• 500 — Internal server error

Code Examples

Here are some quick integration snippets:

• cURL

        curl -X POST https://api.automas.sms.com/sms/send \
             -d "api_key=YOUR_API_KEY" \
             -d "to=8801700000000" \
             -d "message=Hello from Automas"
                                        

• PHP

        $ch = curl_init();
        curl_setopt($ch, CURLOPT_URL, "https://api.automas.sms.com/sms/send");
        curl_setopt($ch, CURLOPT_POST, true);
        curl_setopt($ch, CURLOPT_POSTFIELDS, [
            'api_key'  => 'YOUR_API_KEY',
            'to'       => '8801700000000',
            'message'  => 'Hello World!'
        ]);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        $response = curl_exec($ch);
        curl_close($ch);
                                        

• Node.js (Axios)

        const axios = require('axios');

        axios.post('https://api.automas.sms.com/sms/send', {
          api_key: 'YOUR_API_KEY',
          to: '8801700000000',
          message: 'Hello Automas!'
        })
        .then(res => console.log(res.data))
        .catch(err => console.error(err));