> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.cal.id/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 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

Log in to **Cal ID**, click **Settings**, scroll the left sidebar to the **Developer** section, and click **API Keys**.

![](https://storage.crisp.chat/users/helpdesk/website/-/6/f/1/c/6f1c2c7b8034d000/image_1qy16ld.png =1149x615)

|| Start a new key

Click **Create an API Key**. A configuration window appears.

![](https://storage.crisp.chat/users/helpdesk/website/-/6/f/1/c/6f1c2c7b8034d000/image_1ulhqua.png =1149x615)

|| 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](https://cal.id/docs/api-reference/introduction), 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.