Skip to content
LeadPattern
Reference/Outgoing Messages/Batch Send Messages

Batch Send Messages

POSThttps://public.leadpattern.com/whatsapp/message/batch
WhatsApp Connectedapplication/json60 req/min

Send one request to multiple recipients, each with its own message type and content (text, image, document, audio, video, location). Each recipient counts as one request against the API key's per-minute rate limit.

  • Consumes messages.length rate-limit units, not one.

Headers

1 field
Authorizationstring
required
Your API key. Sent raw (e.g. 'lp_...'). No Bearer prefix required.

Body Parameters

1 field
messagesarray of objects
required
Batch of messages, one per recipient (non-empty).
tostring
required
Recipient phone number in E.164 format (with country code).
typeenum
required
Message type.
Allowed values:
textimagedocumentaudiovideolocation
contentobject
required
Content shape depends on type — same as the matching single-send endpoint.

Responses

Every message attempted; per-item outcome in the response.
JSON Response
{
  "type": "success",
  "data": {
    "messages": [
      {
        "status": "SENT",
        "recipient": "9195XXXXXXXX",
        "messageId": "wamid.abc123"
      },
      {
        "status": "SENT",
        "recipient": "9196XXXXXXXX",
        "messageId": "wamid.def456"
      }
    ]
  }
}

Sample Request Body

{
  "messages": [
    {
      "to": "+9195XXXXXXXX",
      "type": "text",
      "content": {
        "text": "Hello!"
      }
    },
    {
      "to": "+9196XXXXXXXX",
      "type": "image",
      "content": {
        "url": "https://example.com/promo.jpg",
        "caption": "Check this out!"
      }
    }
  ]
}
← Previous Endpoint
Send Location Message
Next Endpoint →
Send Template Message