Platform & API documentation — SMS, WhatsApp, integrations
AI4AFRICA
Africa's #1 AI-Powered SMS Platform

Ship reliable SMS at scale

Composer, bulk campaigns, OCR contact import, scheduling, wallet billing, and exports — built for teams across Africa.

Bulk + single sendLive delivery statusCSV & phonebooks
10,000+ businessesHigh deliverability99.9% uptime target
AI4Africa SMS automation
Campaign-ready dashboard

Compose

Schedule

Track every message

Status sync, retries, exports, and analytics in one place.

Trusted by teams across retail, healthcare, education, and government in Africa

Everything You Need to Scale Your SMS

From AI-powered contact extraction to advanced analytics — all the tools you need to send millions of SMS efficiently.

OCR Camera Upload

Point your camera at any document, business card, or list to instantly extract phone numbers with AI-powered OCR technology.

CSV File Import

Upload CSV files with thousands of contacts in seconds. Automatic phone number validation and formatting.

AI Message Optimization

Improve tone, fix grammar, personalize messages, and ensure compliance with AI-powered copy assistance.

Smart Scheduling & Recurring Campaigns

Schedule one-time messages or set up recurring campaigns with flexible intervals (minutes, hours, days, weeks, months, years). Full timezone support for all African countries.

Real-time Analytics

Track delivery rates, costs, and engagement with comprehensive dashboards and detailed reports.

Contact Management

Organize contacts into phonebooks, segment audiences, and manage your contact database efficiently.

Bulk SMS Campaigns

Create and manage large-scale SMS campaigns with advanced targeting and personalization options.

Advanced Recurring Automation

Set up automated recurring campaigns with custom start times, flexible intervals, and maximum run limits. Perfect for newsletters, reminders, and ongoing marketing.

Phone Number Validation

Verify and validate phone numbers before sending. Check DND status and number validity.

Sender ID Management

Manage multiple sender IDs for different campaigns and ensure brand recognition.

Instant Delivery

Send millions of SMS in seconds with our high-performance infrastructure and global reach.

Wallet Integration

Seamless payment integration with Paystack. Top up your account and pay as you use.

How It Works

Get started in minutes with our simple 4-step process. From contact upload to delivery tracking.

1

Upload Contacts

Use OCR camera to scan documents, upload CSV files, or manually add contacts. Our AI automatically validates and formats phone numbers.

  • OCR camera for instant number extraction
  • CSV file upload with bulk validation
  • Manual entry with smart formatting
  • Automatic phone number validation
2

Compose & Optimize

Write your message with AI assistance. Get real-time cost preview, grammar checks, and tone optimization suggestions.

  • AI-powered message optimization
  • Real-time cost calculation
  • Grammar and tone improvements
  • Character count and page preview
3

Schedule & Send

Send immediately, schedule one-time messages, or set up recurring campaigns with flexible intervals. Our system handles time zones and ensures reliable delivery.

  • Smart scheduling with timezone support
  • Recurring campaigns (minutes to years)
  • Instant or scheduled delivery
  • Custom start times for recurring jobs
  • Automatic retry on failures
  • Multi-carrier delivery optimization
4

Track & Analyze

Monitor delivery status, costs, and engagement in real-time. Get detailed analytics and insights for your campaigns.

  • Real-time delivery tracking
  • Comprehensive analytics dashboard
  • Cost tracking and reporting
  • Delivery status notifications
Outbound SMS
Single or bulk sending
Inbound (Webhooks)
Receive replies/events
DND Checks
Promo & transactional routes
Delivery Reports
Live status and costs
Recurring Automation
Flexible intervals & limits
Unified API

Same surface for Auth, SMS & WhatsApp

Open full docs

Route map

Prefixes: /api/auth·/api/sms·/api/whatsapp·/api/carrier

Authentication

api.auth — session + API key management

  • POST /api/auth/login
  • POST /api/auth/api-keys
  • GET /api/auth/api-keys
  • POST /api/auth/api-keys/{id}/rotate
SMS

api.sms — send, wallet, scheduling, OCR

  • POST /api/sms/extract-phones
  • POST /api/sms/verify-phones-bulk
  • POST /api/sms/send-sms
  • POST /api/sms/send-bulk
  • GET /api/sms/history
  • GET /api/sms/{message_id}
  • POST /api/sms/schedule
  • POST /api/sms/schedule/recurring
  • GET /api/sms/sender-ids
  • POST /api/sms/sender-ids/request
  • DELETE /api/sms/sender-ids/{sender_id}
  • GET /api/sms/wallet/balance
  • GET /api/sms/wallet/transactions
  • POST /api/sms/wallet/initiate-payment
  • POST /api/sms/wallet/verify-payment/{reference}
WhatsApp

api.whatsapp — Cloud API & templates

  • POST /api/whatsapp/send-whatsapp
  • POST /api/whatsapp/send-template
  • GET /api/whatsapp/templates
  • POST /api/whatsapp/templates
  • GET /api/whatsapp/templates/{template_id}
  • POST /api/whatsapp/templates/{template_id}
  • DELETE /api/whatsapp/templates/{template_id}
Carrier (Nigeria)

api.carrier — unified gateway extra

  • GET /api/carrier/lookup
  • GET /api/carrier/prefixes
Meta

Service root

  • GET /
  • GET /health
  • GET /docs
ai4africa-api — request.py
import requests

BASE = "https://your-api-host"  # e.g. unified AI4Africa API
API_KEY = "sk_live_xxxxxxxx"

r = requests.post(
    f"{BASE}/api/sms/send-sms",
    headers={
        "X-API-Key": API_KEY,
        "Content-Type": "application/json",
    },
    json={
        "to": "+2348012345678",
        "message": "Hello from AI4Africa",
        "sender_id": "YourBrand",
    },
    timeout=30,
)
print(r.status_code, r.json())
Example response
{
  "ok": true,
  "message_id": "msg_8f2a…c91",
  "status": "queued",
  "cost_ngn": 8.0
}

Illustration only — paths match the unified AI4Africa API layout. See the doc at /docs .

Trusted by African Teams

See what teams across retail, healthcare, and education are saying.

AR
Ada Retail
Head of Growth
"Campaigns to 8k+ customers sent in minutes. Cost preview is perfect."
CC
City Clinic
Operations Lead
"SMS reminders cut no‑shows by 42%. Scheduling is a game changer."
E
EduRise
Marketing
"AI copy assist boosted click‑throughs by 31%."

Simple pricing

One transparent rate for Nigeria routes. DND may differ on your plan.

8
per page (generic, 160 chars)
Loading USD…
Fallback: ₦1500 / $1
  • Single or bulk campaigns (up to 10,000 recipients)
  • Real‑time cost preview and delivery tracking
  • Promotional (generic) and transactional (dnd) routes
  • AI copy assist for tone, grammar, personalization
  • Image → Numbers: extract and validate phone numbers
  • Phonebooks, contact import (CSV), segmentation
  • Scheduling with date/time picker; auto‑retry failed sends
  • DND checks, delivery reports, webhook support

Note: GSM-7 vs Unicode changes pages (160 vs 70 chars). Pricing is per page.

Wallet billing · exports · webhooks

Ready to automate SMS?

Start your free trial. No credit card required.

|