Connect Guesty

You connect Guesty to PX Accounting through the Guesty Marketplace: you authorize PX Accounting inside Guesty, Guesty gives you a one-time key, and you paste that key into PX.

​

Before you start

You will need an admin user on your Guesty account. In PX, open Settings. In the Connect Your PMS card, pick Guesty. The connect form opens below the provider grid, reading Connect your Guesty account by pasting the API key Guesty gives you. Back to provider selection returns you to the grid.

​

Connect Guesty

1. Click Open PX Accounting in Guesty - this opens PX’s partner page in Guesty. Click Connect there.
2. Guesty shows you an API key. Click Copy.
3. Back in PX, paste it into Integration token and click Connect Guesty.

Guesty’s dialog calls it an API key and PX labels the field Integration token - they are the same value. PX exchanges it for the credentials it stores, which is why there is nothing left to manage afterwards and the connected card has no editable fields. The connection grants read access to listings, reservations, and accounting data. PX never writes back to Guesty.

​

Confirming the connection

Once connected, the Guesty API Credentials card shows Your Guesty account is connected and syncing properties, along with the date the connection was established. The Integration Status card below it reports a single health row:

• Webhooks - green check when it reads Registered and active. PX has registered its webhook endpoint with your Guesty account, so listing and reservation changes reach PX as they happen.

The card also shows a read-only Guesty Account ID, with your Guesty account name beneath it. Quote that ID if you contact Guesty support. If the field reads Not read from Guesty yet. It appears after the next sync, your connection predates the field and it fills in on the next daily sync.

​

What PX reads from Guesty

PX has read-only access. Nothing is written back. Properties - id, name, address, bedrooms / bathrooms / accommodates, currency, default cleaning fee, active flag, thumbnail. Synced on connect, on Guesty listing.* webhooks, and on Properties -> Sync from Guesty. Reservations - id, listing, status, check-in / check-out, booking date, guest name and count, channel, confirmation code, currency, totals (amount, paid, balance, refunded), cancellation snapshot. Synced on demand (Property detail), on reservation.* webhooks, and during audits. Per-charge financial data - line amount and type (accommodation / fee / expense / tax), taxable flag, per-night accommodation breakdown, per-reservation totals. Synced with the parent reservation. Tax catalog - account-level and per-listing taxes: rates, applicability, metadata. Synced on Tax Configuration -> Refresh from PMS. Webhook events - listing.new / updated / removed, reservation.new / updated, and payments.* (acknowledged - financial state is re-read from the reservation, not the webhook payload, so a missed event never causes drift).

​

Reconnecting

Disconnect PX Accounting on its partner page in Guesty, connect again to get a fresh key, then paste it into PX. The Integration token field only appears when no connection exists, so if you already have a new key in hand, click Delete in PX first to get the form back.

​

Removing the connection

Open Settings, go to the Guesty API Credentials card, and click Delete. Confirm in the dialog. This:

• Removes the stored credentials.
• Unregisters the webhook.
• Removes all synced properties.

Your business models, tax configuration, and audit history are account-level and are not removed by deleting the PMS connection.

​

Troubleshooting

Webhooks row reports a failure. PX could not register its webhook. Most often this is a Guesty plan limitation - some plans cap the number of webhooks. Remove an unused webhook in Guesty and retry from the Integration Status card. Connect Guesty fails after pasting the token. The key has already been used or has expired - Guesty keys are single-use and last about 3 hours. Disconnect PX Accounting in Guesty, connect again for a fresh key, and paste that one. Sync runs but no properties appear. Check that the listings are marked active in Guesty. Also confirm the Guesty user that authorized the connection has visibility into the listings - sub-accounts may be restricted. The Guesty Account ID field is empty. Expected on connections made before PX started recording the account ID. It appears after the next daily sync.

​

What’s next