{
"name": "Welcome Campaign",
"recipients": [
"233241234567",
"233501234567"
],
"sender_id": "MYCOMPANY",
"message": "Hello! Welcome to our service."
}
{
"name": "Group Campaign",
"group_ids": [
"ee9fb0b4-83f0-4be5-a0be-1063e05ff0b8"
],
"sender_id": "MYCOMPANY",
"message": "Hello [First Name]! Check out our new offers."
}
{
"name": "Scheduled Campaign",
"recipients": ["233241234567"],
"sender_id": "MYCOMPANY",
"message": "This is a scheduled message!",
"scheduled_at": "2026-01-15 14:30:00"
}
{
"name": "Weekly Newsletter",
"group_ids": ["ee9fb0b4-83f0-4be5-a0be-1063e05ff0b8"],
"sender_id": "MYCOMPANY",
"message": "Weekly update from our team!",
"is_recurring": true,
"recurrence_frequency": "weekly",
"recurrence_interval": 1,
"recurrence_ends_at": "2026-12-31 23:59:59"
}
{
"success": true,
"data": {
"id": 4,
"uuid": "d7c3f89d-fe97-4d47-907c-g53ec363e78e",
"name": "Welcome Campaign",
"total_recipients": 2,
"messages_sent": 0,
"credits_used": "0.00",
"sender_id": "MYCOMPANY",
"status": "pending",
"scheduled_at": null,
"is_recurring": false,
"created_at": "2026-01-15T10:30:00.000000Z",
"updated_at": "2026-01-15T10:30:00.000000Z"
}
}
{
"success": false,
"message": "The given data was invalid.",
"errors": {
"sender_id": ["The selected sender id is invalid."],
"message": ["The message field is required."]
}
}
SMS Campaigns
Create SMS Campaign
Create a new SMS campaign to send messages to your contacts
POST
https://sendazi.com
/
api
/
v1
/
sms-campaigns
{
"name": "Welcome Campaign",
"recipients": [
"233241234567",
"233501234567"
],
"sender_id": "MYCOMPANY",
"message": "Hello! Welcome to our service."
}
{
"name": "Group Campaign",
"group_ids": [
"ee9fb0b4-83f0-4be5-a0be-1063e05ff0b8"
],
"sender_id": "MYCOMPANY",
"message": "Hello [First Name]! Check out our new offers."
}
{
"name": "Scheduled Campaign",
"recipients": ["233241234567"],
"sender_id": "MYCOMPANY",
"message": "This is a scheduled message!",
"scheduled_at": "2026-01-15 14:30:00"
}
{
"name": "Weekly Newsletter",
"group_ids": ["ee9fb0b4-83f0-4be5-a0be-1063e05ff0b8"],
"sender_id": "MYCOMPANY",
"message": "Weekly update from our team!",
"is_recurring": true,
"recurrence_frequency": "weekly",
"recurrence_interval": 1,
"recurrence_ends_at": "2026-12-31 23:59:59"
}
{
"success": true,
"data": {
"id": 4,
"uuid": "d7c3f89d-fe97-4d47-907c-g53ec363e78e",
"name": "Welcome Campaign",
"total_recipients": 2,
"messages_sent": 0,
"credits_used": "0.00",
"sender_id": "MYCOMPANY",
"status": "pending",
"scheduled_at": null,
"is_recurring": false,
"created_at": "2026-01-15T10:30:00.000000Z",
"updated_at": "2026-01-15T10:30:00.000000Z"
}
}
{
"success": false,
"message": "The given data was invalid.",
"errors": {
"sender_id": ["The selected sender id is invalid."],
"message": ["The message field is required."]
}
}
string
required
Name of the campaign for identification
array
Array of phone numbers (international, local, or with + prefix). Either
recipients or group_ids must be provided.array
Array of group UUIDs to target. Either
recipients or group_ids must be provided.string
required
Your approved sender ID
string
required
The message content to send. You can use placeholders like
[First Name] for personalization.string
Schedule the campaign for a future time. Format:
YYYY-MM-DD HH:MM:SSboolean
default:"false"
Enable recurring campaign
string
Frequency of recurrence:
daily, weekly, or monthlyinteger
default:"1"
Interval between recurrences (e.g., every 2 weeks)
string
End date for recurring campaign. Format:
YYYY-MM-DD HH:MM:SS{
"name": "Welcome Campaign",
"recipients": [
"233241234567",
"233501234567"
],
"sender_id": "MYCOMPANY",
"message": "Hello! Welcome to our service."
}
{
"name": "Group Campaign",
"group_ids": [
"ee9fb0b4-83f0-4be5-a0be-1063e05ff0b8"
],
"sender_id": "MYCOMPANY",
"message": "Hello [First Name]! Check out our new offers."
}
{
"name": "Scheduled Campaign",
"recipients": ["233241234567"],
"sender_id": "MYCOMPANY",
"message": "This is a scheduled message!",
"scheduled_at": "2026-01-15 14:30:00"
}
{
"name": "Weekly Newsletter",
"group_ids": ["ee9fb0b4-83f0-4be5-a0be-1063e05ff0b8"],
"sender_id": "MYCOMPANY",
"message": "Weekly update from our team!",
"is_recurring": true,
"recurrence_frequency": "weekly",
"recurrence_interval": 1,
"recurrence_ends_at": "2026-12-31 23:59:59"
}
{
"success": true,
"data": {
"id": 4,
"uuid": "d7c3f89d-fe97-4d47-907c-g53ec363e78e",
"name": "Welcome Campaign",
"total_recipients": 2,
"messages_sent": 0,
"credits_used": "0.00",
"sender_id": "MYCOMPANY",
"status": "pending",
"scheduled_at": null,
"is_recurring": false,
"created_at": "2026-01-15T10:30:00.000000Z",
"updated_at": "2026-01-15T10:30:00.000000Z"
}
}
{
"success": false,
"message": "The given data was invalid.",
"errors": {
"sender_id": ["The selected sender id is invalid."],
"message": ["The message field is required."]
}
}
Was this page helpful?