Skip to content
Booking Engine API Docs

Getting your API keys

Your website or booking widget needs one or two keys to talk to your booking system. An account admin can issue these directly from your dashboard’s API Keys & Widget screen — no need to ask us for a routine key.

Issue a key yourself

Section titled “Issue a key yourself”
  1. Open API Keys & Widget in your dashboard.
  2. Click Issue key, give it a name (so you can tell it apart later — for example “Website integration”), and pick the kind (below).
  3. For a publishable key, add the website address(es) it’s allowed to run on, one per line.
  4. Copy the key immediately and save it somewhere safe: a password manager, not a chat message or a note you might lose.

Only an account admin can issue or revoke keys. If you don’t see this screen, ask whoever set up your account to add you as an admin, or to issue the key for you.

The two kinds

Section titled “The two kinds”
  • A secret key. Goes only on your website’s own server — hand it to your developer or agency, never anywhere public. It can do everything we’ve allowed for your account: read guest details, create and cancel bookings, change your rates.
  • A publishable key. Safe to be visible on your website — it’s what our booking widget uses, and what the read-only calendar box uses too. It can check availability, get a price, start a hold, and take a guest to a secure Stripe payment page. It can’t read a guest’s name or email, and it can’t move money on its own, even if someone finds it by viewing your page’s source code.

If you’re not sure which one your developer is asking for, see Secret keys vs. publishable keys.

Test keys vs. live keys

Section titled “Test keys vs. live keys”

When you issue a key, you choose whether it’s a test key or a live key. Test keys let you and your developer try the whole booking flow safely, without touching real guest bookings or real money — build and test with those first. Once everything works, issue a live pair for the same purpose. Nothing about how your website talks to the API changes, only the key itself.

If you lose a key

Section titled “If you lose a key”

We never see the full value again after it’s issued, so we can’t recover a lost key for you. Issue a new one and update it wherever the old one was used — see If a key leaks for the same steps, which apply whether the key leaked or you simply misplaced it.

Next steps

Section titled “Next steps”