> ## Documentation Index
> Fetch the complete documentation index at: https://developer.clopos.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhooks

> Event-driven notifications from the Clopos Open API

# Webhooks

<Note>
  Webhooks are **not yet available** on Clopos Open API v2. Support is on the roadmap and will be released in the near future.
</Note>

Once webhooks ship, Clopos will push event notifications to an HTTPS endpoint you register, so you can react to changes — new orders, closed receipts, stop-list updates — without polling.

## In the meantime

Until webhooks are available, the recommended pattern is **polling the relevant list endpoints** with a sensible interval and date filter:

* [List receipts](/api-reference/v2/receipts/get-receipts) — filter with `date[0]` / `date[1]` and sort by `created_at` descending to pick up new activity.
* [List orders](/api-reference/v2/orders/get-orders) — same pattern for order lifecycle tracking.
* [Get stop list](/api-reference/v2/products/get-stop-list) — poll on your own cadence for menu availability changes.

Keep polling intervals reasonable (seconds, not milliseconds) and stay within the per-tenant quota described on the [Rate limits](/rate-limits) page.

## Want early access?

If your integration has a concrete use case for webhooks and you would like to be notified (or participate in the beta) when they ship, contact [dev@clopos.com](mailto:dev@clopos.com) with your `integrator_id` and a short description of the events you need.