# Guesty direct connection

Source: https://lemon.cy/connect/guesty/  
Publisher: Lemon.cy (Red Tribe Media Ltd, Limassol, Cyprus)  
Updated: 2026-09-10 · Verified against production: 2026-09-10

**Short answer:** Connect Guesty with your API credentials (OAuth2 client credentials). Lemon receives reservation webhooks and polls every 30 minutes as a backstop, maps each Guesty listing to a Lemon property, and creates a checkout cleaning job for every confirmed reservation. Cancellations arrive as events, so nothing is inferred from a calendar.

## Setting it up

1. In Guesty, create API credentials for an integration (client ID and secret).
2. In Lemon: Settings → Integrations → Guesty → enter the credentials. Lemon verifies them against Guesty and lists your properties.
3. Map each Guesty listing to a Lemon property (or create one). Properties connected this way have their iCal feeds deactivated.
4. Lemon registers a webhook endpoint (`/api/pms/webhooks/guesty`, signed) and begins the 30-minute poll.

## What arrives

The reservation object: status, check-in and checkout, platform (Airbnb, Booking.com, direct), guest count and the reservation code. As with every PMS connection, guest personal data is not retained. A confirmed reservation creates a checkout job at the property's checkout time; a changed checkout moves the job and tells the cleaner; a cancellation cancels the job and tells the cleaner immediately — no waiting window, because the cancellation is a fact.

## Reliability

Webhook deliveries are logged (`pms_webhook_logs`); the poller reconciles anything missed. The connection's status (active, error, disconnected) is visible in Settings, and a pause notice is sent to the host if the credentials stop working.

## Related

- [Hostaway direct connection](https://lemon.cy/connect/hostaway/)
- [Hospitable direct connection](https://lemon.cy/connect/hospitable/)
- [iCal or a direct PMS connection — which is better for cleaning automation?](https://lemon.cy/learn/ical-vs-direct-pms-connection-for-cleaning-automation/)
