Skip to main content

Webhooks

Webhooks are not yet available on Clopos Open API v2. Support is on the roadmap and will be released in the near future.
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 — filter with date[0] / date[1] and sort by created_at descending to pick up new activity.
  • List orders — same pattern for order lifecycle tracking.
  • 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 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 [email protected] with your integrator_id and a short description of the events you need.