Bulk Send

Send up to 100 messages in a single API call.

POST /v1/notify/:channel/bulk
X-Api-Key: notifo_live_...
Content-Type: application/json

Request body

{
  "messages": [
    { "to": "+905551234567", "text": "Hello Alice!" },
    { "to": "+905559876543", "text": "Hello Bob!" },
    { "to": "+905553456789", "text": "Hello Charlie!" }
  ]
}

Field	Type	Required	Description
messages	array	yes	1–100 send-text objects (same shape as send text)

Response 202 Accepted

Returns an array of message objects — one per input message — in the same order:

[
  { "id": "msg_01j...", "to": "+905551234567", "status": "queued", ... },
  { "id": "msg_01j...", "to": "+905559876543", "status": "queued", ... },
  { "id": "msg_01j...", "to": "+905553456789", "status": "queued", ... }
]

Notes

• Each message is queued independently; one failure does not block others.
• Idempotency keys are supported per-message.
• The 100-message limit is enforced; requests exceeding it return 422 Unprocessable Entity.

cURL

curl -X POST https://api.notifo.cloud/v1/notify/whatsapp/bulk \
  -H "X-Api-Key: notifo_live_abc123" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      {"to": "+905551111111", "text": "Reminder: Your appointment is tomorrow."},
      {"to": "+905552222222", "text": "Reminder: Your appointment is tomorrow."}
    ]
  }'

Node.js

const recipients = ['+905551111111', '+905552222222'];

const res = await fetch('https://api.notifo.cloud/v1/notify/whatsapp/bulk', {
  method: 'POST',
  headers: { 'X-Api-Key': 'notifo_live_abc123', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    messages: recipients.map((to) => ({
      to,
      text: 'Reminder: Your appointment is tomorrow.',
    })),
  }),
});
const results = await res.json();