Introduction

SendAfrica is a Tanzania-first SMS platform: a REST API, official SDKs, and an AI agent for sending and managing SMS at scale.

SendAfrica is a Tanzania-first SMS automation platform. It gives you three building blocks that work together:

A REST API for sending SMS, managing contacts and campaigns, credit billing, payments, and notifications.
Official SDKs for Python, TypeScript, C# (.NET), PHP, C++, and Dart that wrap the API with typed responses, automatic retries, and webhook verification helpers.
A SendAfrica Agent — an in-app multi-channel AI assistant and FastMCP tool server that can answer questions *and* take actions (send SMS, check balances, create campaigns) on behalf of authenticated users.

#The platform at a glance

Component	URL	What it is
Dashboard	`https://app.sendafrica.online`	User-facing web app — compose SMS, phonebook, campaigns, billing
REST API	`https://api.sendafrica.online`	The `/v1` HTTP API this documentation covers
MailAfrica	`https://app.mailafrica.online`	Sibling product for transactional email (`MA-...` API keys)
Agent service	`POST /v1/agent/chat`	AI assistant + MCP tool server (SMS & email actions)

#How sending works

Every send follows the same pipeline — validation, credit accounting, gateway dispatch, logging, and automatic refunds on failure:

sms flow

text

Request → validate phone (TZ mobile only)
        → count SMS parts (GSM-7 / UCS-2)
        → deduct credits (atomic, idempotent, Idempotency-Key aware)
        → hand off to the SMS gateway
        → log result to message_logs
        → refund credits on gateway failure/rejection

Delivery status arrives asynchronously via webhook at /v1/sms/callback, deduplicated in Redis before updating the message log.

#Where to next

Follow the Quickstart to send your first SMS in five minutes.
Skim Authentication to pick between API keys and JWT.
Grab an official SDK from the SDKs section.
Explore the AI Agent if you want conversational, tool-using automation.

Quickstart