---
title: "Subscribe to Webhooks"
method: POST
path: "/"
tags: ["Webhooks"]
---

# Subscribe to Webhooks

`POST /`

To subscribe to webhooks for all businesses a Biz Owner has access to
send an [authenticated](https://docs.developer.yelp.com/docs/authorization-code-workflow)
POST request to the `https://api.yelp.com/v3/webhooks`.

Note: Currently only `leads_event` [webhooks](https://docs.developer.yelp.com/docs/leads-webhooks)
are supported (`NEW_EVENT`, `CONSUMER_PHONE_NUMBER_OPT_IN_EVENT`, `CONSUMER_PHONE_NUMBER_OPT_OUT_EVENT`).

**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.

## Response `200`

200 OK - Webhook successfully subscribed

- object
  - `webhook_id` string — The unique identifier for the webhook subscription.
  - `expiration_date` string — The date and time when the webhook subscription will expire. (ISO 8601 format)

## Other responses

- `400` — unresolved $ref
- `401` — The API key has either expired or doesn't have the required scopes to query this endpoint. | code | description | | ------------- | ------------- | | UNAUTHORIZED_API_KEY | The API key provided is not currently able to query this endpoint. | | TOKEN_INVALID | Invalid API key or authorization header. |
- `409` — Conflict
- `429` — You have either exceeded your daily quota, or have exceeded the queries-per-second limit for this endpoint. Try reducing the rate at which you make queries.
- `500` — Internal Server Error

---

[API](https://skmtc.net/yelp/apis/businesses.md) · [All operations](https://skmtc.net/yelp/apis/businesses/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/yelp/businesses/revisions/d3f744f55ed7/schema)