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

Campaigns are the core of Sendazi. They allow you to send messages to your contacts, either immediately or on a schedule.

​
Campaign Types

SMS Campaigns

Send text messages to your contacts. Perfect for promotions, notifications, and alerts.

Voice Campaigns

Send automated voice calls with custom audio files or text-to-speech messages.

​
Creating a Campaign

​
1. Choose Recipients

You have two options for selecting recipients:
  • Direct Phone Numbers: Specify a list of phone numbers directly
  • Contact Groups: Select one or more groups from your contacts
Phone numbers can be in international format (e.g., 233241234567), local format (e.g., 0241234567), or with a plus prefix (e.g., +233241234567). Local numbers are automatically converted to international format.

​
2. Select a Sender ID

Choose an approved sender ID that will appear as the sender of your messages. You can manage your sender IDs in the dashboard or via the API.

​
3. Compose Your Message

Write your message content. You can use placeholders for personalization:
PlaceholderDescription
[First Name]Contact’s first name
[Last Name]Contact’s last name
[Phone Number]Contact’s phone number
Example: 
Hello [First Name]! Thank you for being a valued customer.

​
4. Schedule (Optional)

You can send your campaign immediately or schedule it for later: 
{
  "scheduled_at": "2026-01-20 09:00:00"
}

​
5. Set Up Recurring (Optional)

For regular communications, you can set up recurring campaigns: 
{
  "is_recurring": true,
  "recurrence_frequency": "weekly",
  "recurrence_interval": 1,
  "recurrence_ends_at": "2026-12-31 23:59:59"
}

​
Campaign Statuses

StatusDescription
pendingCampaign is queued and waiting to be processed
processingCampaign is currently being sent
completedAll messages have been sent
failedCampaign failed to send

​
Best Practices

Use placeholders to make your messages more personal. Personalized messages have higher engagement rates.
Always send a test campaign to yourself before launching to your full audience.
Consider your audience’s timezone when scheduling campaigns. Avoid sending messages too early or too late.
SMS messages are limited to 160 characters for a single segment. Longer messages will be split and may cost more credits.

​
API Reference

SMS Campaigns API

Create and manage SMS campaigns via API

Voice Campaigns API

Create and manage voice campaigns via API