zinn-campaigns

POST /v1/webhooks/campaigns/whatsapp

WhatsApp delivery receipts and STOP replies from Meta.

All zinn-campaigns endpoints

All developer docs →

Zinn®, our Viking, hammering at his anvil beside an API endpoint sending events to several listeners.

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/whatsapp

Signed 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

NameTypeRequiredWhat it is
X-Hub-Signature-256 (header)stringNo—

Response

NameTypeRequiredWhat it is
okbooleanYes—
queuedstringYesThe background run handling this body.

Errors this endpoint can return

400 · 401 · 503