Create, secure, and rotate a Cal ID API key so you can connect your scheduling data to external applications and authenticate REST API requests.
The Cal ID API key is a secure credential that connects your scheduling data with external applications, custom websites, or the API docs. It lets different software systems communicate with your Cal ID account safely.
Log in to your Cal ID account, click Settings, then scroll the left sidebar to the Developer section and click API Keys.
Finding where your keys are managed
2
Start a new key
Click Create an API Key in the top-right corner of the API Keys page. 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 helps you identify 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.
Leave the toggle OFF, open the Expiration date dropdown, and choose 7 days, 30 days, 3 months, or 1 year.
Once this date passes, the key expires and the integration stops working until you create a new one.
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.
For your protection, Cal ID will never show this key again. If you close the window without copying it, delete the entry and create a new one.
Prefer to explore interactively? Open the API Reference, click Authorize, paste your key, and run any endpoint against your live account right from the docs.
Every response returned for your key carries X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset headers, and Cal ID answers with 429 Too Many Requests once you run out of allowance. Read API rate limits for the retry and back-off pattern to build in from the start — and note that using a separate key per integration makes it far easier to spot which one is being noisy.