You can manage API keys from the Integrations page under API keys. Bokko lets you create integration-type keys, choose their capabilities, optionally set an expiry date, and revoke them later if they are no longer needed.
Create a new API key
- Open Integrations in the dashboard.
- Go to the API keys section and click Create.
- Enter a key name.
- Select at least one capability.
- Optionally choose an expiry date.
- Confirm the creation.
WarningBokko shows the raw API key only once, right after creation. Save it securely before you close the dialog, because the raw key is not shown again later.
Available capabilities
| Capability | What it allows |
|---|---|
| availability.read | Read availability data |
| booking.create | Create bookings through the API |
| booking.read | Read booking data |
| booking.cancel | Cancel bookings through the API |
| services.read | Read services |
| staff.read | Read staff data |
| webhook.manage | Manage webhook-related functionality |
What you see in the key list
- Key name
- Key suffix instead of the full secret
- Capability chips
- Status such as active, expired or revoked
- Last used date when Bokko has usage data for that key
Revoke a key
- Find the key in the API keys list.
- Click Revoke.
- Confirm the action.
Revocation is the right choice if a key is no longer in use, was exposed, or should stop working immediately. Bokko keeps the key in the list with revoked status instead of showing the raw key again.