Skip to main content
POST
/
voice-campaigns
curl -X POST "https://sendazi.com/api/v1/voice-campaigns" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "name=Audio Announcement" \
  -F "group_ids[]=ee9fb0b4-83f0-4be5-a0be-1063e05ff0b8" \
  -F "sender_id=MYCOMPANY" \
  -F "audio=@/path/to/audio.mp3"

{
  "success": true,
  "data": {
    "id": 2,
    "uuid": "9c026029-25e7-5d3b-b3dg-g7d4e9ecd956",
    "name": "Audio Announcement",
    "total_recipients": 25,
    "messages_sent": 0,
    "credits_used": "0.00",
    "status": "pending",
    "audio_url": "https://sendazi.com/storage/audio/9c026029.mp3",
    "created_at": "2026-01-15T11:00:00.000000Z",
    "updated_at": "2026-01-15T11:00:00.000000Z"
  }
}

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.

This endpoint accepts multipart/form-data when uploading an audio file, or application/json when using text-to-speech.
​
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
​
audio
file
Audio file to broadcast (MP3, WAV, OGG). Either audio or message must be provided.
​
message
string
Text message to be converted to speech (text-to-speech). Either audio or message must be provided.
​
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
​
recurrence_ends_at
string
End date for recurring campaign

​
Audio File Requirements

FormatMax SizeMax Duration
MP310 MB5 minutes
WAV10 MB5 minutes
OGG10 MB5 minutes
curl -X POST "https://sendazi.com/api/v1/voice-campaigns" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "name=Audio Announcement" \
  -F "group_ids[]=ee9fb0b4-83f0-4be5-a0be-1063e05ff0b8" \
  -F "sender_id=MYCOMPANY" \
  -F "audio=@/path/to/audio.mp3"

{
  "success": true,
  "data": {
    "id": 2,
    "uuid": "9c026029-25e7-5d3b-b3dg-g7d4e9ecd956",
    "name": "Audio Announcement",
    "total_recipients": 25,
    "messages_sent": 0,
    "credits_used": "0.00",
    "status": "pending",
    "audio_url": "https://sendazi.com/storage/audio/9c026029.mp3",
    "created_at": "2026-01-15T11:00:00.000000Z",
    "updated_at": "2026-01-15T11:00:00.000000Z"
  }
}