Bulk Messages

Omdaa API provides a powerful system for sending bulk messages to thousands of recipients at once. You can send bulk messages via API or upload a CSV file.

Create Bulk Job

To create a bulk sending job via API:

"function">curl "keyword">-X POST https://omdaa.com/api/v1/bulk \
  "keyword">-H "Authorization: Bearer YOUR_JWT_TOKEN" \
  "keyword">-H "Content"keyword">-Type: application/json" \
  "keyword">-d '{
  "sessionId": "my"keyword">-instance",
  "message": "Hello! This is a bulk message",
  "recipients": ["966501234567", "966501234568", "966501234569"]
}'

Upload CSV File

To send bulk messages from a CSV file:

"function">curl "keyword">-X POST https://omdaa.com/api/v1/bulk/upload class="keyword">-csv \
  "keyword">-H "Authorization: Bearer YOUR_JWT_TOKEN" \
  "keyword">-F "file=@recipients.csv" \
  "keyword">-F "sessionId=my"keyword">-instance" \
  "keyword">-F "message=Hello from CSV!"

CSV File Format

number,message
966501234567,Hello from CSV!
966501234568,Hello from CSV!
966501234569,Hello from CSV!

Get Job Status

To track the status of a bulk sending job:

"function">curl "keyword">-X GET "https://omdaa.com/api/v1/bulk/bulk class="keyword">-job"keyword">-id/status" \
  "keyword">-H "Authorization: Bearer YOUR_JWT_TOKEN"

Job States

pending
Job is queued
processing
Job is being processed
completed
Job completed
paused
Job is paused
failed
Job failed

💡 Tips

  • You can pause and resume bulk jobs
  • Use CSV files for large jobs (more than 1000 recipients)
  • Track job status regularly to monitor progress
  • Respect sending limits to avoid being blocked