Webhooks: Calendar

Webhook notifications for calendar activity.

Guesty's Open API allows you to send calendar-related webhook notifications to your application's notification URL(s).


What Notifications Can I Receive?

Calendar notifications are sent by Guesty when there are calendar-related events such as:

  • Changes in availability.
  • Updates to nightly rates.
  • Alteration to the minimum stay requirement.

🚧

New and altered reservation events don't trigger this webhook. Instead, you should subscribe to the reservation webhooks and call the Calendar API to retrieve the data for the dates included in the reservation webhook payload.

To account for advance notice or preparation time, you may wish to include the relevant days before and after the reservation in your request to capture these blocks.


Why Create a Calendar Webhook?

Once your Guesty Open API integration is complete and finished with its initial data synchronization, we recommend you utilize the calendar webhook. Webhooks will help you save time and resources. Plus, you get to only synchronize the calendar data that has changed and ignore that which has remained in the same state since the initial synchronization.


Calendar Updated

This webhook is sent whenever a change is made to availability, pricing, or minimum nights. Learn how to subscribe to this webhook here.


Webhook to Subscribe

listing.calendar.updated


Webhook Payload

Body ParameterData TypeDescription
accountIdobjectThe unique ID of your Guesty account.
calendar[object]List of objects describing the changes made to the calendar.
eventstringlisting.calendar.updated

Payload Example

{
    "listing": {
        "accountId": "563e0b6a08a2710e00057b82"
    },
    "calendar": [
        {
            "date": "2022-08-30",
            "listingId": "5faa154685cfc0002f7bbd1d",
            "currency": "NZD",
            "price": 15000,
            "isBasePrice": false,
            "minNights": 1,
            "isBaseMinNights": true,
            "status": "available",
            "blocks": {
                "m": false,
                "r": false,
                "b": false,
                "bd": false,
                "sr": false,
                "abl": false,
                "a": false,
                "bw": false,
                "o": false,
                "pt": false
            },
            "blockRefs": [],
            "cta": false,
            "ctd": false,
            "notDefaultAvailability": true,
            "rulesApplied": [
                {
                    "rule": "repeated days (tuesday)",
                    "minNights": 1,
                    "cta": false,
                    "ctd": false
                },
                {
                    "rule": "2 days 18%",
                    "minNightsPriority": 10
                }
            ],
            "listing": {
                "_id": "5faa154685cfc0002f7bbd1d",
                "prices": {
                    "currency": "NZD"
                }
            }
        }
    ],
    "event": "listing.calendar.updated"
}

πŸ“˜

Multi-Unit Availability

To properly ascertain the availability of a multi-unit upon the receipt of this webhook for changes to a sub-unit, you are encouraged to send a request to retrieve the calendar information for the same dates on the multi-unit itself.