To subscribe to webhooks for all businesses a Biz Owner has access to
send an authenticated
POST request to the https://api.yelp.com/v3/webhooks.
Note: Currently only leads_event webhooks
are supported (NEW_EVENT, CONSUMER_PHONE_NUMBER_OPT_IN_EVENT, CONSUMER_PHONE_NUMBER_OPT_OUT_EVENT).
Subscription Expiration
A webhook subscription will have a default expiration date of 14 days.
To ensure no loss of data, it is recommended you unsubscribe and subscribe again
at least an hour before the expiration date and time.
The expiration_date field in the response indicates when the subscription will expire (ISO 8601 format).
Set expiration_days to 0 for a subscription that does not expire.
Payload Signature Verification
All webhook deliveries are signed using Ed25519. To verify the authenticity and integrity of webhook payloads, see Webhook Signature Verification.
Signature verification replaces the previous IP-allowlist workaround. We strongly recommend adopting signature verification for improved security.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
