Skip to main content
POST
/
whatsapp
/
broadcasts
curl --request POST \
--url https://api.kapso.ai/platform/v1/whatsapp/broadcasts \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '{
"whatsapp_broadcast": {
"name": "Weekend Sale 2025",
"phone_number_id": "1234567890",
"whatsapp_template_id": "784203120908608"
}
}'
{
  "data": {
    "id": "5f6a7b8c-9d0e-1f2a-3b4c-5d6e7f8a9b0c",
    "name": "Weekend Sale 2025",
    "status": "draft",
    "started_at": null,
    "completed_at": null,
    "created_at": "2025-07-14T15:00:00Z",
    "updated_at": "2025-07-14T15:00:00Z",
    "phone_number_id": "1234567890",
    "whatsapp_template": {
      "id": "784203120908608",
      "meta_template_id": "784203120908608",
      "name": "weekend_sale_2025",
      "language_code": "en_US",
      "category": "MARKETING",
      "status": "approved",
      "components": [
        {
          "type": "BODY",
          "text": "Hi {{name}}! Get {{discount}}% off this weekend only!",
          "example": {
            "body_text_named_params": [
              {
                "param_name": "name",
                "example": "John"
              },
              {
                "param_name": "discount",
                "example": "25"
              }
            ]
          }
        }
      ]
    },
    "total_recipients": 0,
    "sent_count": 0,
    "failed_count": 0,
    "delivered_count": 0,
    "read_count": 0,
    "responded_count": 0,
    "pending_count": 0,
    "response_rate": 0
  }
}

Authorizations

X-API-Key
string
header
required

Body

application/json
whatsapp_broadcast
object
required

Response

Created

data
object
required