Quick start: send your first SMS

Send your first message in a few minutes.

1. Create an account and complete KYC

2. Provision a phone number

Call POST /v1/numbers/provision with a country_code. The response contains the provisioned number in E.164 format.

3. Send an SMS

import requests

r = requests.post(
    "https://api.reachcell.com/v1/sms/send",
    headers={
        "Authorization": "Bearer ak_your_api_key",
        "Content-Type":  "application/json",
    },
    json={
        "from": "+14155552671",   # your provisioned number
        "to":   "+14155553000",   # destination
        "body": "Hello from ReachCell",
    },
)
msg = r.json()["data"]
print(msg["message_id"], msg["status"])

<?php
$ch = curl_init('https://api.reachcell.com/v1/sms/send');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer ak_your_api_key',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'from' => '+14155552671',
        'to'   => '+14155553000',
        'body' => 'Hello from ReachCell',
    ]),
]);
$body = json_decode(curl_exec($ch), true);
curl_close($ch);

echo $body['data']['message_id'];  // 2a583efc-...
echo $body['data']['status'];      // dispatched

const res = await fetch('https://api.reachcell.com/v1/sms/send', {
  method: 'POST',
  headers: {
    Authorization:  'Bearer ak_your_api_key',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    from: '+14155552671',
    to:   '+14155553000',
    body: 'Hello from ReachCell',
  }),
});
const { data } = await res.json();
console.log(data.message_id, data.status);

4. Check the status

Poll GET /v1/sms/{message_id} to see the current status, or receive updates via the sms.sent and sms.delivered webhooks.