Skip to main content

Integration via Webhooks

Webhooks provide a mechanism for receiving real-time booking information without the need for periodic server requests. EasyWeek enables you to configure and manage webhooks efficiently, ensuring seamless integration with your systems.

Webhook Management​

Visit the Webhooks page under the Developer menu in the Settings section to manage your webhooks. Here, you can configure up to five webhooks and monitor their status and performance.

If you need to create a new webhook, click the +Add button and provide the following parameters:

  • Method: Choose between POST (full payload sent when the event occurs) or GET (a short message without a Body segment).
  • URL: Specify the address where your system will receive the webhook.
  • Response Codes: Define comma-separated HTTP codes considered as a successful result of the sending.
  • Description: Add explanatory text for convenience (not sent) to describe the purpose of the webhook.

On the right side of the page, select the type of event you want to track. You can choose from available triggers, including specific events or all available events.

Automatic Disabling Settings​

Configure settings to automatically disable the webhook in case of sending errors:

  • Set the number of attempts to send and the interval between them.
  • Activate or deactivate the shutdown option.
  • Specify the email address to receive notifications about webhook disconnection.

Custom Parameters​

Add custom parameters as needed. For example, include parameters that your system expects, such as an authorization segment in incoming webhooks.

Request History​

Each webhook maintains a detailed request history. Access it by navigating to Settings - Developer menu - Webhooks, selecting the required webhook, and clicking on it. The opened page displays brief information about the webhook and a detailed submission log at the bottom. You can filter entries by date, success rate, or event type.

Select any entry to view details of the data sent, and a "Resend" button is available for all attempts.

Sent Data​

For a comprehensive understanding of the variables used during webhook sending, refer to the Message Templates.

Specific Settings​

If you have specific requirements for webhooks or need more than five, contact our support team. Provide details such as:

  • The URL to receive notifications.
  • Events to send notifications about (e.g., creation, cancellation, record change).
  • The data you are interested in (entire payload or customized set).
  • Method (POST or GET), parameters of successful sending, tracked events, and custom attributes if needed.

Please note that webhooks are available only on the PRO plan.

For more detailed information, visit the Webhooks Documentation.