Send Bulk Message

Send the same message to multiple recipients (max 50). The message body follows the same structure as single message operations — specify the message_type and its required fields.

Recipients are deduplicated automatically. Empty phone numbers are ignored.

Authorization

ApiKeyAuth

X-API-Key<token>

API key from your dashboard (Settings > API Keys)

In: header

Optional. Attribute this send to a specific agent, overriding the agent bound to the API key. The agent must belong to your account and be active (role AGENT, parent = your account) — otherwise the request returns 400. Drives customer assignment, agent allotment limits, and the wallet ledger entry.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

to*array<>

Array of recipient phone numbers with country code

Items1 <= items <= 50

scheduleTime?string

Optional. Format DD-MM-YYYY:HH-MM, interpreted in IST (Asia/Kolkata). If provided, the message is held until this time and dispatched by a cron job (runs every 2 minutes). Must be in the future and within 30 days. The wallet is charged immediately at request time. Response shape becomes {id, scheduledAt} instead of the usual session-details payload.

Match^\d{2}-\d{2}-\d{4}:\d{2}-\d{2}$

message*

Message payload (same structure as single message operations)

Response Body

`application/json`

curl -X POST "https://loading/api/v1/messages/send/bulk" \  -H "X-AGENT-ID: agt_abc123" \  -H "Content-Type: application/json" \  -d '{    "to": [      "919876543210",      "919876543211",      "919876543212"    ],    "message": {      "message_type": "template",      "template_name": "promotion_offer",      "template_language": "en_US",      "body_variables": [        "30%",        "March 31, 2026"      ]    }  }'

{
  "success": true,
  "data": {
    "results": [
      {
        "to": "string",
        "id": "string",
        "error": "string"
      }
    ]
  }
}

{
  "success": false,
  "message": "to field is required"
}

{
  "success": false,
  "message": "user not authenticated"
}

{
  "success": false,
  "message": "insufficient balance to send message"
}

{
  "success": false,
  "message": "internal server error"
}

Send Bulk Message

Authorization

Header Parameters

Request Body

Response Body

201application/json

400application/json

401application/json

402application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`