Send to Address Book

POST /v1/sms/send-group/

{
  "group_ids": ["3f8e2d1a-...", "7b4c9e0f-..."],
  "message":   "Hi! Your statement is ready. Log in at app.example.com",
  "sender_id": "TALKNTALK"
}

curl -X POST https://api.talkntalk.africa/v1/sms/send-group/ \
  -H "Authorization: Bearer tk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "group_ids": ["3f8e2d1a-7c4d-4e1a-b3f2-9d8e2c1a4b5f"],
    "message":   "Your monthly statement is ready.",
    "sender_id": "TALKNTALK"
  }'

{
  "campaign_id":      84,
  "status":           "queued",
  "recipients_count": 1248,
  "group_names":      ["Premium Customers"],
  "sender_id":        "TALKNTALK",
  "estimated_cost":   "KES 1248.00"
}

// 1. Get address book IDs
const books = await fetch('https://api.talkntalk.africa/v1/address-books/', {
  headers: { Authorization: 'Bearer tk_live_xxxx' },
}).then(r => r.json());
 
const groupIds = books.results.map(b => b.id); // or pick specific ones
 
// 2. Send to all books
const res = await fetch('https://api.talkntalk.africa/v1/sms/send-group/', {
  method:  'POST',
  headers: { Authorization: 'Bearer tk_live_xxxx', 'Content-Type': 'application/json' },
  body:    JSON.stringify({
    group_ids: groupIds,
    message:   'Hello! Your invoice is ready.',
    sender_id: 'TALKNTALK',
  }),
});
const campaign = await res.json();
console.log(`Queued ${campaign.recipients_count} messages — cost ${campaign.estimated_cost}`);

import requests
 
API_KEY = 'tk_live_xxxx'
HEADERS = {'Authorization': f'Bearer {API_KEY}'}
 
# 1. Get address book IDs
books = requests.get('https://api.talkntalk.africa/v1/address-books/', headers=HEADERS).json()
group_ids = [b['id'] for b in books['results']]  # or filter by name
 
# 2. Send campaign
r = requests.post(
    'https://api.talkntalk.africa/v1/sms/send-group/',
    headers=HEADERS,
    json={
        'group_ids': group_ids,
        'message':   'Hello! Your invoice is ready.',
        'sender_id': 'TALKNTALK',
    },
)
campaign = r.json()
print(f"Queued {campaign['recipients_count']} messages | {campaign['estimated_cost']}")

$apiKey = 'tk_live_xxxx';
 
// 1. Get address book IDs
$ch = curl_init('https://api.talkntalk.africa/v1/address-books/');
curl_setopt_array($ch, [CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => ["Authorization: Bearer {$apiKey}"]]);
$books    = json_decode(curl_exec($ch), true);
$groupIds = array_column($books['results'], 'id');
curl_close($ch);
 
// 2. Send campaign
$ch = curl_init('https://api.talkntalk.africa/v1/sms/send-group/');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_HTTPHEADER     => ["Authorization: Bearer {$apiKey}", 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS     => json_encode([
        'group_ids' => $groupIds,
        'message'   => 'Hello! Your invoice is ready.',
        'sender_id' => 'TALKNTALK',
    ]),
]);
$campaign = json_decode(curl_exec($ch), true);
echo "Queued {$campaign['recipients_count']} messages | {$campaign['estimated_cost']}";