Create your API key
1
Open the developer dashboard
Log in to your Cal ID account, click Settings, then scroll the left sidebar to the Developer section and click API Keys.

2
Start a new key
Click Create an API Key. A configuration window appears.

3
Name the key
Enter a descriptive name in the Name this key field — for example, “My Personal Portfolio” or “Zapier Integration.” A clear name makes it easy to tell later which app uses which key.
4
Set an expiration
Decide how long the key stays active.
- Never expires
- Set an expiry date
Switch the Never expires toggle ON. The key stays active until you manually delete it.
5
Create and copy the key
Click Create. Your secret key is shown once — click the copy icon and paste it somewhere safe, like a password manager.
Make your first request
Send an authenticated request to theme endpoint to confirm your key works — it returns your profile details.
curl:
calid_XXXXXX with your API key.
Key security rules
- Never share your API key in emails, chat messages, or public code repositories like GitHub.
- Use separate keys for different integrations — safer than reusing one key everywhere.
- Revoke unused keys from the API Keys page with the Delete (trash) icon to cut off access instantly.
Next steps
Explore the API Reference
Authorize once, then try every endpoint against your live account.
Create your first booking
A step-by-step recipe for booking through the API.