Skip to main content
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."]
  }
}
​
name
string
required
Name of the campaign for identification
​
recipients
array
Array of phone numbers (international, local, or with + prefix). Either recipients or group_ids must be provided.
​
group_ids
array
Array of group UUIDs to target. Either recipients or group_ids must be provided.
​
sender_id
string
required
Your approved sender ID
​
message
string
required
The message content to send. You can use placeholders like [First Name] for personalization.
​
scheduled_at
string
Schedule the campaign for a future time. Format: YYYY-MM-DD HH:MM:SS
​
is_recurring
boolean
default:"false"
Enable recurring campaign
​
recurrence_frequency
string
Frequency of recurrence: daily, weekly, or monthly
​
recurrence_interval
integer
default:"1"
Interval between recurrences (e.g., every 2 weeks)
​
recurrence_ends_at
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."]
  }
}