Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.pxaccounting.com/llms.txt

Use this file to discover all available pages before exploring further.

PX Accounting connects to Hospitable (formerly Smartbnb) with a Personal Access Token (PAT) you generate inside Hospitable.
Hospitable in the PMS picker

​
Before you start

You will need:
  • A paid Hospitable plan. The Essentials plan does not include public API access; if you are on Essentials, upgrade first.
  • An owner-level login.

​
Step 1 - generate a Personal Access Token

  1. Sign in to Hospitable: my.hospitable.com.
  2. In the sidebar, open Apps (or Settings -> Integrations).
  3. Click API access.
  4. Switch to the Access tokens tab.
  5. Click + Add new.
  6. Give the token a name like PX Accounting and create it.
  7. Copy the token.
For details, see Hospitable’s article: Accessing the Public API with a Personal Access Token.
Personal Access Tokens expire after 1 year. Set a reminder to re-issue and update PX before the expiry, or audits will start failing.

​
Step 2 - paste the token into PX

  1. In PX, open Settings.
  2. In the PMS Connection card, pick Hospitable.
  3. Paste the Personal Access Token.
  4. Click Save credentials.
PX validates the token and the Integration Status panel shows three lights: Admin, OAuth, and Webhook.

​
What PX reads from Hospitable

PX has read-only access. Nothing is written back. Properties - id, name, address, bedrooms / bathrooms / max guests, property type, currency, active flag, thumbnail. Synced on connect, on listing webhooks, and on Properties -> Sync from Hospitable. Reservations - id, listing, status, check-in / check-out, booking date, guest details (subject to channel masking), guest count breakdown, channel and confirmation codes, currency, totals. Synced on demand, on reservation webhooks, and during audits. Per-charge financial data - per-night accommodation, cleaning / pet / extra-guest / custom fees, taxes per type, channel commission and host service fee, guest-paid vs. host-payout split. Synced with the parent reservation. Tax catalog - rates, names, applicability per listing. Synced on Tax Configuration -> Refresh from PMS. Webhook events - reservation created / updated / canceled, listing created / updated, channel connection changes. Hospitable exposes per-night pricing (not just the stay average), so audits can verify accommodation amounts to the day.

​
Removing the connection

Open Settings, scroll to the PMS Connection card, and click Delete. This removes the token from PX and unregisters webhooks.

​
Troubleshooting

Admin status is red. The token is wrong or has been revoked in Hospitable. Generate a new PAT and update PX. Token expired. Hospitable PATs expire after 1 year. Re-issue and update PX. API access is disabled. Hospitable’s Essentials plan does not include public API. Upgrade to a paid tier and try again.