Your messages on your customers' phones, in seconds

Single send, then bulk send.

import requests

base = 'https://app.sparrowmessage.com/api/v1'

# — Authentication
token = requests.post(f'{base}/login', json={
    'email': 'you@company.com',
    'password': 'your-password',
}).json()['api_token']

headers = {'Authorization': f'Bearer {token}', 'Accept': 'application/json'}

# — Send an SMS
r = requests.post(f'{base}/sms/send/one', headers=headers, json={
    'phone':     '+2126XXXXXXXX',
    'text':      'Your verification code is 385 214.',
    'notifyurl': 'https://your-site.com/sparrow/status',
}).json()

print('SMS envoyé' if r['code'] == 'OK' else f"Échec : {r['error']}")

# — Bulk send: one request, several recipients
requests.post(f'{base}/sms/send/bulk', headers=headers, json={
    'phones': ['+2126XXXXXXXX', '+2126YYYYYYYY'],
    'text':   'Soldes : -20 % jusqu\'à dimanche. STOP au 36000',
})

# — Delivery status, from the identifier returned
status = requests.post(f'{base}/sms/status', headers=headers, json={
    'message_id': '8f21c4',
}).json()
print(status['result'])

Node 18 or later: fetch is built in.

const base = 'https://app.sparrowmessage.com/api/v1';

// — Authentication
const { api_token } = await fetch(`${base}/login`, {
  method:  'POST',
  headers: { 'Content-Type': 'application/json', Accept: 'application/json' },
  body:    JSON.stringify({
    email:    'you@company.com',
    password: 'your-password',
  }),
}).then(r => r.json());

const headers = {
  'Content-Type': 'application/json',
  Accept:         'application/json',
  Authorization: `Bearer ${api_token}`,
};

// — Send an SMS
const reponse = await fetch(`${base}/sms/send/one`, {
  method:  'POST',
  headers: headers,
  body: JSON.stringify({
    phone:     '+2126XXXXXXXX',
    text:      'Your verification code is 385 214.',
    notifyurl: 'https://your-site.com/sparrow/status',
  }),
}).then(r => r.json());

console.log(reponse.code === 'OK' ? 'SMS envoyé' : `Échec : ${reponse.error}`);

// — Bulk send
await fetch(`${base}/sms/send/bulk`, {
  method:  'POST',
  headers: headers,
  body: JSON.stringify({
    phones: ['+2126XXXXXXXX', '+2126YYYYYYYY'],
    text:   'Soldes : -20 % jusqu\'à dimanche. STOP au 36000',
  }),
});

.NET 6 or later.

using System.Net.Http.Json;

var http = new HttpClient { BaseAddress = new Uri("https://app.sparrowmessage.com/api/v1/") };

// — Authentication
var auth = await http.PostAsJsonAsync("login", new {
    email    = "you@company.com",
    password = "your-password",
});
var token = (await auth.Content.ReadFromJsonAsync<Dictionary<string, string>>())["api_token"];
http.DefaultRequestHeaders.Authorization = new("Bearer", token);

// — Send an SMS
var msg = await http.PostAsJsonAsync("sms/send/one", new {
    phone     = "+2126XXXXXXXX",
    text      = "Your verification code is 385 214.",
    notifyurl = "https://your-site.com/sparrow/status",
});

var result = await msg.Content.ReadFromJsonAsync<Dictionary<string, object>>();
Console.WriteLine(result["code"].ToString() == "OK" ? "SMS envoyé" : $"Échec : {result["error"]}");

// — Bulk send
await http.PostAsJsonAsync("sms/send/bulk", new {
    phones = new[] { "+2126XXXXXXXX", "+2126YYYYYYYY" },
    text   = "Soldes : -20 % jusqu'à dimanche. STOP au 36000",
});

Java 11 or later, native HTTP client.

import java.net.URI;
import java.net.http.*;

var client = HttpClient.newHttpClient();
var base   = "https://app.sparrowmessage.com/api/v1";

// — Authentication
var auth = HttpRequest.newBuilder(URI.create(base + "/login"))
    .header("Content-Type", "application/json")
    .header("Accept", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString("""
        {"email":"you@company.com","password":"your-password"}"""))
    .build();

var token = extract(client.send(auth, HttpResponse.BodyHandlers.ofString()).body(), "api_token");

// — Send an SMS
var msg = HttpRequest.newBuilder(URI.create(base + "/sms/send/one"))
    .header("Content-Type", "application/json")
    .header("Accept", "application/json")
    .header("Authorization", "Bearer " + token)
    .POST(HttpRequest.BodyPublishers.ofString("""
        {"phone":"+2126XXXXXXXX",
         "text":"Your verification code is 385 214.",
         "notifyurl":"https://your-site.com/sparrow/status"}"""))
    .build();

System.out.println(client.send(msg, HttpResponse.BodyHandlers.ofString()).body());

Copy and paste into a terminal.

# — 1. Get the token
curl -X POST https://app.sparrowmessage.com/api/v1/login \
     -H "Accept: application/json" \
     -H "Content-Type: application/json" \
     -d '{"email":"you@company.com","password":"your-password"}'

# Response: {"code":"OK","api_token":"eyJ0eXAiOiJKV1Qi..."}

# — 2. Send an SMS
curl -X POST https://app.sparrowmessage.com/api/v1/sms/send/one \
     -H "Accept: application/json" \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer $TOKEN" \
     -d '{"phone":"+2126XXXXXXXX",
          "text":"Your verification code is 385 214.",
          "notifyurl":"https://your-site.com/sparrow/status"}'

# — 3. Bulk send
curl -X POST https://app.sparrowmessage.com/api/v1/sms/send/bulk \
     -H "Accept: application/json" \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer $TOKEN" \
     -d '{"phones":["+2126XXXXXXXX","+2126YYYYYYYY"],
          "text":"Reminder: your appointment is tomorrow at 2:30 pm."}'

# — 4. Delivery status
curl -X POST https://app.sparrowmessage.com/api/v1/sms/status \
     -H "Accept: application/json" \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer $TOKEN" \
     -d '{"message_id":"8f21c4"}'

# — 5. Status of a batch
curl -X POST https://app.sparrowmessage.com/api/v1/sms/status/bulk \
     -H "Accept: application/json" \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer $TOKEN" \
     -d '{"messages_id":["8f21c4","8f21c5"]}'