How to Get Your Cal ID API Key?

The Cal ID API key is a secure credential that connects your scheduling data to external applications, custom websites, or the API docs. It lets different systems talk to your Cal ID account safely.

Create your API key

Open the developer dashboard

Start a new key

Click Create an API Key. A configuration window appears.

Name the key

Enter a descriptive name in Name this key — for example, "My Personal Portfolio" or "Zapier Integration." A clear name helps you identify later which app uses which key.

Set an expiration

Never expires: switch the Never expires toggle ON — the key stays active until you delete it.
Set an expiry date: leave the toggle OFF, then choose 7 days, 30 days, 3 months, or 1 year. Once it passes, the key expires and the integration stops working until you create a new one.

Create and copy the key

Click Create. Your secret key is shown once — copy it and store 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.

Make your first request

Send an authenticated request to the me endpoint to confirm your key works — it returns your profile details.

GET https://api.cal.id/users/me

The same call with curl:

curl -X 'GET' \
  'https://api.cal.id/users/me' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer calid_XXXXXX'

Replace calid_XXXXXX with your API key. Prefer to explore interactively? Open the API Reference, click Authorize, paste your key, and try any endpoint against your live account.

Key security rules

Never share your API key in emails, chats, or public 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.

Updated on: 24/08/2026

Was this article helpful?

Thank you!