> For the complete documentation index, see [llms.txt](https://octotable-1.gitbook.io/octotable-api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://octotable-1.gitbook.io/octotable-api/webhooks.md).

# Webhooks

ℹ️ OctoTable provides webhooks to automatically notify your system when certain events related to reservations occur.\
To start receiving notifications, you need to register an HTTP endpoint (URL) that OctoTable will call with a `POST` request whenever the selected event takes place.

\
⚙️ **Use the base resource URL** for the following examples, or [see the complete collection](https://documenter.getpostman.com/view/36615570/2sB2qZDgok#8cc26f7c-20c6-4db9-b585-57c7d40f091e)\
`https://api.octorate.com/octotable-pms/api/v2`

**✅ How to register a webhook**

To set up a webhook, send a `POST` request to the appropriate endpoint, specifying:

* the event you want to subscribe to,
* and the URL that should receive the notification.

**📌 Available Events**

OctoTable currently supports the following reservation-related events:

* **RESERVATION\_CREATED**\
  Triggered whenever a new reservation is created.
* **RESERVATION\_UPDATED**\
  Triggered when an existing reservation is modified.
* **RESERVATION\_STATUS\_UPDATED**\
  Triggered when a reservation status is updated.
* **RESERVATION\_DELETED**\
  Triggered when a reservation is deleted.
* **ORDER\_SENT**\
  Triggered when all items have been sent together.
* **SINGLE\_ORDER\_SENT**\
  Triggered when a single item is sent.

🔗 Webhook notifications will be sent from OctoTable to the URL you provide.

\
For API calls and examples, use the following base resource URL:\
`https://api.octorate.com/octotable-pms/api/v2`