Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developers.sendazi.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

The Sendazi API is a RESTful API that allows you to programmatically manage SMS and Voice campaigns, contacts, groups, sender IDs, message templates, and more.

Base URL

https://sendazi.com/api/v1

​
Authentication

All API endpoints require authentication using a Bearer token. You can generate API keys from your dashboard. Include your API key in the Authorization header of every request: 
Authorization: Bearer YOUR_API_KEY
Keep your API keys secure. Do not share them or expose them in client-side code.

​
Request Format

All requests should include the following headers: 
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY
For POST and PUT requests, send the request body as JSON.

​
Response Format

All responses are returned in JSON format with a consistent structure:

​
Success Response

{
  "success": true,
  "data": {
    // Response data here
  }
}

​
Paginated Response

{
  "success": true,
  "data": {
    "data": [...],
    "current_page": 1,
    "per_page": 10,
    "total": 100,
    "last_page": 10,
    "from": 1,
    "to": 10
  }
}

​
Error Response

{
  "success": false,
  "message": "Error description",
  "errors": {
    "field_name": ["Validation error message"]
  }
}

​
HTTP Status Codes

CodeDescription
200Success
201Created
400Bad Request
401Unauthorized
404Not Found
422Validation Error
429Too Many Requests
500Internal Server Error

​
Rate Limiting

API requests are rate limited to ensure fair usage. If you exceed the rate limit, you’ll receive a 429 Too Many Requests response.
If you need higher rate limits for your use case, contact our support team.

​
Resource Identifiers

Most resources in Sendazi use UUIDs as identifiers. For example:
  • Campaigns: c6c2f78c-fd96-4c46-806b-f42db252d67d
  • Groups: ee9fb0b4-83f0-4be5-a0be-1063e05ff0b8
  • Sender IDs: 71267203-165e-48c9-a163-5aef1a2c6f01

​
Phone Number Format

Phone numbers can be provided in any of these formats:
  • ✅ 233241234567 — International format
  • ✅ 0241234567 — Local format (automatically converted to international)
  • ✅ +233241234567 — With plus prefix

​
API Resources

SMS Campaigns

Create and manage SMS campaigns

Voice Campaigns

Create and manage voice campaigns

Contacts

Manage your contact database

Groups

Organize contacts into groups

Sender IDs

Manage your sender IDs

Templates

Create reusable message templates

Account

Manage your account and billing

API Keys

Generate and manage API keys

​
SDKs & Libraries

We’re working on official SDKs for popular programming languages. In the meantime, you can use any HTTP client to interact with our API.
Need help? Contact our support team at support@sendazi.com.