Skip to main content
POST
/
api
/
messaging
/
campaigns
{
  "name": "Holiday Promotion",
  "message": "Special holiday offer! Get 20% off",
  "recipients": [
    "+255614853618",
    "+255712345678"
  ],
  "sender_id": "MIFUMO",
  "scheduled_at": "2025-12-01T10:00:00Z",
  "segment_ids": [],
  "contact_ids": []
}

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Holiday Promotion",
  "message": "Special holiday offer! Get 20% off",
  "status": "scheduled",
  "scheduled_at": "2025-12-01T10:00:00Z",
  "total_recipients": 2,
  "sent": 0,
  "delivered": 0,
  "failed": 0,
  "created_at": "2025-11-27T10:30:00Z",
  "updated_at": "2025-11-27T10:30:00Z"
}
Create a new SMS campaign.
​
name
string
required
Campaign name
​
message
string
required
SMS message content
​
recipients
array
Array of recipient phone numbers
​
sender_id
string
required
Sender ID
​
scheduled_at
string
Scheduled send time (ISO 8601 format)
​
segment_ids
array
Array of segment IDs
​
contact_ids
array
Array of contact IDs

​
Request Example

{
  "name": "Holiday Promotion",
  "message": "Special holiday offer! Get 20% off",
  "recipients": [
    "+255614853618",
    "+255712345678"
  ],
  "sender_id": "MIFUMO",
  "scheduled_at": "2025-12-01T10:00:00Z",
  "segment_ids": [],
  "contact_ids": []
}

​
Success Response (201)

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Holiday Promotion",
  "message": "Special holiday offer! Get 20% off",
  "status": "scheduled",
  "scheduled_at": "2025-12-01T10:00:00Z",
  "total_recipients": 2,
  "sent": 0,
  "delivered": 0,
  "failed": 0,
  "created_at": "2025-11-27T10:30:00Z",
  "updated_at": "2025-11-27T10:30:00Z"
}