X

Send an SMS

Use the API to send an SMS message to a recipient's mobile device.

[POST] https://api-us1.stannp.com/v1/sms/create

Parameters

test optional If set to true, the SMS message will not be sent and there will be no charge.
phone_number optional The recipient's phone number. Required if recipient_id is not provided.
recipient_id optional ID of a recipient that has already been added to your account. Required if phone_number is not provided.
message mandatory The message to be sent. You can use template tags if using recipient_id (e.g., Hi {firstname}).
country optional A 2-character country code (e.g., US, CA, GB). Defaults to your account region.

Request

                <?php
$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => "https://api-us1.stannp.com/v1/sms/create?api_key={API_KEY}",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 0,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_POSTFIELDS => array(
        'phone_number' => "12345678901",
        'message' => "Hello World"
    ),
    
));

$response = curl_exec($curl);

curl_close($curl);
print_r($response);
?>

Response

{
    "success": true,
    "data": {
        "id": 0,
        "recipient_id": 0,
        "phone_number": "01234567890",
        "from": "STANNP",
        "profile_id": 3,
        "usage_campaign_id": 0,
        "profile_type": "sender_id",
        "message": "Hello World",
        "message_parts": 1,
        "cost": 0.002,
        "destination_country": "US",
        "status": "test",
        "campaign_id": 0,
        "created": "2024-07-25T16:16:28+00:00",
        "updated": ""
    }
}