Quickstart

From nothing to your first SMS in under five minutes.

1. Get your key

Sign in to your DroidSender account
Open the API page
Click New key
Give it a name and copy it (format DS-live-xxxx)

2. Check that a device is online

bash

curl -X GET https://api.droidsender.com/api/v1/devices \
  -H "X-API-Key: DS-live-your-key"

3. Send your first SMS

bash

curl -X POST https://api.droidsender.com/api/v1/sms/send \
  -H "Content-Type: application/json" \
  -H "X-API-Key: DS-live-your-key" \
  -d '{
    "to": "+351912345678",
    "message": "Your appointment on 10/08 at 11:15 is confirmed.",
    "deviceId": "dev_oppo_cph2577"
  }'

The same in Python

python

import requests

r = requests.post(
    "https://api.droidsender.com/api/v1/sms/send",
    headers={"X-API-Key": "DS-live-your-key"},
    json={
        "to": "+351912345678",
        "message": "Your appointment on 10/08 at 11:15 is confirmed.",
        "deviceId": "dev_oppo_cph2577",
    },
    timeout=10,
)
print(r.json())

The same in JavaScript

javascript

const r = await fetch("https://api.droidsender.com/api/v1/sms/send", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-API-Key": "DS-live-your-key",
  },
  body: JSON.stringify({
    to: "+351912345678",
    message: "Your appointment on 10/08 at 11:15 is confirmed.",
    deviceId: "dev_oppo_cph2577",
  }),
});
console.log(await r.json());

Sent is not delivered

The response confirms the message left for the network. Delivery confirmation arrives later, through the sms.delivered webhook.