Queue in Bulk
Send up to 500 messages in a single request
queue_bulk
Queue many messages at once. Send an items array where each item has the same shape as a queue_sms body. You can mix channels in one call. Maximum 500 items per request.
Authentication
Header
Authorization: Bearer YOUR-API-KEY
Body Parameters
| Field | Type | Description | |
|---|---|---|---|
| items | array | required | 1–500 message objects. Each item accepts to, message, channel, and (for email) subject / smtp_server_id, plus optional scheduled_at — exactly like queue_sms. |
Invalid items (missing
to/message, a bad email address, or a missing email subject) are skipped, not fatal — the rest of the batch still queues. The response reports how many were skipped.Example Request
cURL
curl -X POST "https://api.rcszilla.com/?endpoint=queue_bulk" \
-H "Authorization: Bearer YOUR-API-KEY" \
-H "Content-Type: application/json" \
-d '{
"items": [
{ "to": "+40700000001", "message": "Hi Ana!", "channel": "sms" },
{ "to": "+40700000002", "message": "Reminder for you", "channel": "whatsapp" },
{ "to": "ana@example.com", "subject": "Welcome", "message": "<p>Thanks for joining!</p>", "channel": "email" }
]
}'
Response
JSON200 OK
{
"success": true,
"message": "Queued",
"ids": [1051, 1052, 1053],
"count": 3,
"skipped": 0
}
| Field | Type | Description |
|---|---|---|
| ids | array | Queue IDs of the messages that were accepted, in order. |
| count | integer | How many items were queued. |
| skipped | integer | How many items were skipped as invalid. |
Errors
| Status | Message | Cause |
|---|---|---|
| 400 | items array is required | items missing or empty. |
| 400 | Maximum 500 items per call | More than 500 items in one request — split into batches. |
| 401 | Unauthorized | Missing or invalid API key. |