Every request needs an API key. Pass it in the Authorization header:
A missing key returns 401. An invalid key, or a key used for a different venue, returns 403.
Create an API key
You need to be an organisation admin to create API keys.
- In NowBookIt, click your profile icon (bottom left), then select Organisation settings.
- Click the Settings icon (bottom left), then go to Integrations → API Keys.
- Click Issue a key.
- Select Your own integration.
- Enter a name for the key, select One venue, choose your venue, then click Continue.
- Select what the key may do (Reservations, Sales), then click Create key.
- Click Copy key and store it somewhere safe, then click Done.
Each key works for one venue. Create a separate key for each venue you integrate with.
The key is shown only once. Keep it secure and never expose it in client-side code, public repositories or logs.
Lost or exposed keys
Your keys are listed under Integrations → API Keys. Click the ··· menu next to a key to:
- Regenerate - create a new key. The old key keeps working, so nothing breaks while you swap them over.
- Suspend - stop the key working until you reinstate it.
- Delete - remove the key permanently.