v1
latestOpenAPI 3.1.02026-07-22115189303.8 KBWebhooks
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