Webhooks: Listings

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

What Notifications Can I Receive?

Guesty sends listing notifications for new listings when settings and content are changed or when a listing is removed.

Why Subscribe to Listing Webhooks?

There are several benefits to subscribing to listing webhooks.

1. Stay informed about your inventory.
2. Stay updated on changes to existing inventory.
3. Save time and resources by synchronizing only the altered listings.

New Listing

This webhook is sent upon the creation of a new listing. Learn how to subscribe to this webhook here.

Webhook to Subscribe

listing.new

Webhook Payload

Payload Example

{
  "event": "listing.new",
  "listing": { <Listing object data> },
  "meta": {
    "eventId": "<event_id>",
    "messageId": "<message_id>"
  }
}

Listing Updated

This webhook is sent whenever a change is made to a listing's settings or content within your Guesty account. Learn how to subscribe to this webhook here.

Webhook to Subscribe

listing.updated

Webhook Payload

Payload Example

{
  "event": "listing.updated",
  "listing": { <Listing object data> },
  "meta": {
    "eventId": "<event_id>",
    "messageId": "<message_id>"
  }
}

Listing Removed

Subscribe to this webhook to receive notifications when a listing is deleted from your Guesty account. Learn how to subscribe to this webhook here

Webhook Payload

Payload Example

{
  "event": "listing.removed",
  "listing": { <Listing_object_data> },
  "meta": {
    "eventId": "<event_id>",
    "messageId": "<message_id>"
  }
}