API Introduction

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

Code	Description
`200`	Success
`201`	Created
`400`	Bad Request
`401`	Unauthorized
`404`	Not Found
`422`	Validation Error
`429`	Too Many Requests
`500`	Internal 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.

Overview

SMS Campaigns

Voice Campaigns

Contacts

Groups

Sender IDs

Message Templates

Account

API Keys

Payments

Tools

API Introduction

Overview

Base URL

Authentication

Request Format

Response Format

Success Response

Paginated Response

Error Response

HTTP Status Codes

Rate Limiting

Resource Identifiers

Phone Number Format

API Resources

SMS Campaigns

Voice Campaigns

Contacts

Groups

Sender IDs

Templates

Account

API Keys

SDKs & Libraries

​Overview

Base URL

​Authentication

​Request Format

​Response Format

​Success Response

​Paginated Response

​Error Response

​HTTP Status Codes

​Rate Limiting

​Resource Identifiers

​Phone Number Format

​API Resources

SMS Campaigns

Voice Campaigns

Contacts

Groups

Sender IDs

Templates

Account

API Keys

​SDKs & Libraries

Overview

Authentication

Request Format

Response Format

Success Response

Paginated Response

Error Response

HTTP Status Codes

Rate Limiting

Resource Identifiers

Phone Number Format

API Resources

SDKs & Libraries