Webhooks

Subscribe a WABA to webhooks

Subscribes a WABA so that incoming WhatsApp messages and delivery updates are pushed to your HTTPS callback URL in real time.

Your callback must be live before you call this endpoint. During this request, Meta verifies the URL once by sending GET <overrideCallbackUri>?hub.mode=subscribe&hub.verify_token=<verifyToken>&hub.challenge=<random>. Your endpoint must confirm that hub.verify_token matches your secret and respond 200 with the raw hub.challenge value — otherwise this request fails with 400.

POST

meta

wabas

{wabaId}

webhook-subscriptions

Subscribe a WABA to webhooks

curl --request POST \
  --url https://cerberus.eazybe.com/prod/api/v2/meta/wabas/{wabaId}/webhook-subscriptions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "overrideCallbackUri": "https://your-app.com/webhooks/whatsapp",
  "verifyToken": "shared-secret"
}
'

{
  "success": true
}

The Instant Webhook guide walks through this setup step by step, with ready-to-use callback code in Node.js and Python.

Authorizations

Authorization

string

header

required

Eazybe bearer token. The token resolves the caller's organization and must be kept on the server.

Path Parameters

wabaId

string

required

WhatsApp Business Account ID returned by GET /meta/phone-numbers.

Body

application/json

overrideCallbackUri

string

required

Public HTTPS URL on your server that receives the webhook events. It must be reachable when this request is made, because Meta runs the verification handshake against it.

verifyToken

string

required

A secret string you choose. Meta sends it back as hub.verify_token during the verification handshake so your endpoint can confirm the request is genuine.

Response

200 - application/json

App subscribed to this WABA's events

Failure responses

Status	Meaning	Action
`401`	Missing, invalid, or expired bearer token	Re-authenticate
`404`	`wabaId` not linked to your organization	Verify the id
`400`	Callback URL failed Meta's verification handshake, or is not HTTPS	Return `hub.challenge` on the `GET` handshake
`502`	Graph unreachable or timed out	Retry with backoff

success

boolean

required

Overview

WABA API Documentation

Webhook

Subscribe a WABA to webhooks

Authorizations

Path Parameters

Body

Response