zinn-campaigns
POST /v1/webhooks/campaigns/whatsapp
WhatsApp delivery receipts and STOP replies from Meta.
Authentication
This endpoint is public. It takes no credential and no organisation — it is what our own marketing site and AI answer engines read.
This endpoint takes no organisation id. Your key already identifies the organisation it belongs to, and the response is scoped to it.
Try it
Replace anything in angle brackets with your own values, and the key placeholder with a key from your dashboard.
curl -X POST https://api.zinndigital.com/v1/webhooks/campaigns/whatsappSigned in? The API console in your dashboard fills in your real organisation id and your own key, and runs the request against the live API so you can see the actual response. Open this endpoint in the API console
Details
Unauthenticated by design: X-Hub-Signature-256 (sha256= + the HMAC-SHA256 of the raw body under the secret of one of our Meta apps) is the authentication — 401 when it is missing or does not verify, 503 while no app secret is configured (never accepted unverified). A verified body is queued for a background run and acknowledged at once; 503 when it cannot be queued (Meta retries). The run records each statuses[] entry on the paid WhatsApp message with that id (delivered or read, both recorded as delivered, or failed with Meta's error code; the first receipt stands, so a redelivery is a no-op); a failed with code 131050 (the person stopped marketing messages in WhatsApp) opts the number out. A messages[] entry whose whole text or quick-reply button is a STOP word (STOP, UNSUBSCRIBE, "Stop promotions", ...) opts the number out of WhatsApp for the account whose connected number it reached (for our own number, every account holding it as a contact); START removes a reply opt-out. Every later WhatsApp send to that number is refused as suppressed.
Parameters
| Name | Type | Required | What it is |
|---|---|---|---|
X-Hub-Signature-256 (header) | string | No | — |
Response
| Name | Type | Required | What it is |
|---|---|---|---|
ok | boolean | Yes | — |
queued | string | Yes | The background run handling this body. |
Errors this endpoint can return
400 · 401 · 503