API Reference
Base URLs
| Service | URL |
|---|---|
| SendAfrica API | https://api.sendafrica.online/v1 |
| MailAfrica API | https://api.mailafrica.online |
| Agent Service | http://localhost:8000 |
SendAfrica Endpoints
| Endpoint | Method | Description |
|---|---|---|
/v1/sms/send | POST | Send a single SMS |
/v1/sms/bulk | POST | Send SMS to multiple recipients |
/v1/contacts | GET | List contacts |
/v1/campaigns | POST | Create a campaign |
/v1/credits/balance | GET | Check credit balance |
/v1/vouchers/initiate | POST | Initiate mobile money top-up |
MailAfrica Endpoints
| Endpoint | Method | Description |
|---|---|---|
/v1/emails/send | POST | Send transactional email |
/v1/emails/inbound | GET | List inbound emails |
/v1/credits/balance | GET | Check email credit balance |
Agent Endpoints
| Endpoint | Method | Description |
|---|---|---|
/v1/agent/chat | POST | Dashboard chat endpoint |
/v1/agent/sessions | GET | List account/user sessions |
/v1/agent/sessions/{session_id} | GET | Read session history |
/webhooks/sendafrica | POST | Inbound SMS webhook |
/health | GET | Health check |
/ready | GET | Readiness check |
/sse | GET | MCP SSE server |
Chat and session routes require X-Account-ID and, when caller authentication is enabled, either X-API-Key or Authorization. Chat accepts session_id, message, and optional user_confirmation.
Error Codes
| Code | Description |
|---|---|
| 400 | Bad Request — Invalid parameters |
| 401 | Unauthorized — Invalid or missing API key |
| 403 | Forbidden — Insufficient permissions |
| 404 | Not Found — Resource does not exist |
| 429 | Too Many Requests — Rate limit exceeded |
| 500 | Internal Server Error |
Last updated on