v1

latestOpenAPI 3.1.02026-07-22115189303.8 KB
Webhooks

Create project webhook

Create a webhook for this project.

Two scoping options:

  • Project-scoped: Omit phone_number_id to receive project events only
  • Number-scoped: Include phone_number_id to receive message and conversation events for that number

Project webhooks do not receive message or conversation events. Use a number-scoped webhook (or POST /whatsapp/phone_numbers/{phone_number_id}/webhooks) for those.

Subscribing to project.event requires project events to be available on your plan.

Two webhook types:

  • kapso: Event-based webhooks with filtered events, buffering support, and Kapso payload format
  • meta: Raw Meta webhook forwarding - receives the exact payload Meta sends (requires phone_number_id)
post/whatsapp/webhooks

Request body

Response

Created