Skip to main content
POST
/
v1
/
messages
/
bulk
Schedule a bulk template broadcast to many recipients
curl --request POST \
  --url https://api.keebai.com/v1/messages/bulk \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "phone_number_id": "100000000000001",
  "template_name": "welcome_v2",
  "language": "es",
  "recipients": [
    {
      "to": "+5491155555555",
      "variables": {
        "nombre": "Lucio"
      },
      "meta_data": {}
    }
  ],
  "campaign_name": "Onboarding marzo 2026"
}
'
{
  "broadcast_id": "<string>",
  "status": "scheduled",
  "total_recipients": 123,
  "scheduled_at": "<string>"
}

Authorizations

​
Authorization
string
header
required

Personal Access Token con prefijo kbai_pk_. Generar desde el portal con permiso developer.manage_tokens.

Body

application/json
​
phone_number_id
string
required

WhatsApp Business phone_number_id (numeric identifier issued by Meta for the sending number).

Example:

"100000000000001"

​
template_name
string
required
Example:

"welcome_v2"

​
language
string
required
Example:

"es"

​
recipients
object[]
required
​
campaign_name
string
Example:

"Onboarding marzo 2026"

Response

202 - application/json
​
broadcast_id
string
required
​
status
string
required
Example:

"scheduled"

​
total_recipients
number
required
​
scheduled_at
string | null