Send Bulk Messages

Bulk messaging lets you send to a list of recipients in one operation. Each message goes through the same queue and delivery pipeline as individual sends.

From the dashboard

Go to Messages > Bulk
Upload a CSV or JSON file with recipient phone numbers and message content
Preview the recipient list
Click Send (or schedule for later)

CSV format

to,body
+15551234567,Your appointment is tomorrow at 2pm.
+15559876543,Your appointment is tomorrow at 3pm.

From the API

curl -X POST https://api.coop.example.com/api/v1/messages/bulk \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      {"to": "+15551234567", "body": "Your appointment is tomorrow at 2pm."},
      {"to": "+15559876543", "body": "Your appointment is tomorrow at 3pm."}
    ]
  }'

Track progress

Bulk jobs run in the background. Check on a job's progress:

curl https://api.coop.example.com/api/v1/messages/bulk/JOB_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

Get results

Once a job completes, pull per-recipient delivery status:

curl https://api.coop.example.com/api/v1/messages/bulk/JOB_ID/results \
  -H "Authorization: Bearer YOUR_API_KEY"

Each result includes the recipient, message status (delivered, failed, etc.), and error details if applicable.