How to create and revoke a Timeo API key.
API keys let your own software read or write Timeo data, such as bookings and customers, server to server.
- Who it is for
- Owners and developers
- Plan
- Team only
Generate an API key
- Open Settings, open Advanced settings and tap Developers.
- Tap Generate key.
- Fill in Name, for example Back-office integration.
- Tick only the scopes it needs, such as Read bookings, Write bookings, Read customers or Read orders. Add an Expires (optional) date if you like.
- Tap Generate key. Copy the token with Copy to clipboard: it is shown once.
- Store it in a secure secret manager and send it as a Bearer token in the Authorization header.
Revoke a key
In the keys table, tap Revoke on the key and confirm. It stops working straight away and shows Revoked. The table also shows when each key was Last used.
What your customers see
- Nothing changes for customers. Developers see the key in the table with its Prefix, Scopes and Last used date.
Common problems
- I lost the token. Can I see it again?
- No. Tokens are shown once. Revoke the old key and generate a new one.
- Developers is locked in my menu.
- API access is part of the Team plan. Upgrade in Settings > Billing & plan.
Related guides
- How to set up webhooks for bookings, orders and customers
- How to upgrade or downgrade your Timeo plan
More in Account and settings, or start with the getting started guide. Still stuck? Contact us.