Guesty

The Guesty integration uses the Guesty Open API with your Client ID and Client Secret. Guesty does not use a browser OAuth flow — TogoFlow exchanges your credentials for a bearer token automatically and caches it for up to 24 hours.

What you can do

Step 1 — Create API credentials

1. Log in to your Guesty account.
2. Go to Integrations → Open API.
3. Create a new application and copy your Client ID and Client Secret.

Guesty only shows the client secret once. Store it securely — you cannot retrieve it later from the Guesty UI.

See Guesty authentication docs for details.

Step 2 — Connect in TogoFlow

1. Add an Action node and select Guesty.
2. Choose an action (e.g. List Listings).
3. Enter your Client ID and Client Secret in the credentials section.
4. Fill in the action fields and save.

TogoFlow fetches a bearer token from POST https://open-api.guesty.com/oauth2/token and reuses it until it expires. Tokens are cached per organization to stay within Guesty's limit of 5 token requests per 24 hours per client ID.

Common workflows

Check availability and create a booking

1. Search Available Listings — set check-in, check-out, and min occupancy.
2. Create Quote — use a listing ID from step 1.
3. Create Reservation from Quote — pass the quote ID and guest details.

See Reservations V3 booking flow in Guesty's docs.

Search reservations

Use Search Reservations with a filter query string, for example:

filter[checkIn][gte]=2026-01-01&filter[checkIn][lt]=2026-02-01&filter[status]=confirmed

Template variables

All fields support TogoFlow template syntax, e.g. {{inputs.listingId}} from an upstream webhook or AI node.

Troubleshooting

Related guides

• API Keys — how key-based auth works in TogoFlow
• Action Node — configuring action nodes