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.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Cal ID","description":"Cal ID help center — scheduling, event types, availability, teams, apps, workflows, and developer tools for the Cal ID meeting scheduler.","colors":{"primary":"#1972F5","light":"#5B9BFF","dark":"#0B4FB8"},"logo":{"light":"https://mintcdn.com/cal-id-docs/k1VHQ7P5ONAHeLvP/logo/light.svg?fit=max\u0026auto=format\u0026n=k1VHQ7P5ONAHeLvP\u0026q=85\u0026s=589c4a9c69ea7387516e6452f592553e","dark":"https://mintcdn.com/cal-id-docs/tkghSGJWVIrQX7X0/logo/dark.svg?fit=max\u0026auto=format\u0026n=tkghSGJWVIrQX7X0\u0026q=85\u0026s=3215902115e27959cb7782b1af38e9fe"},"favicon":"https://mintcdn.com/cal-id-docs/NUrc1nmEeHvCjwEV/favicon.svg?fit=max\u0026auto=format\u0026n=NUrc1nmEeHvCjwEV\u0026q=85\u0026s=3247c427392ba77a41b08a807c322bfb","navbar":{"links":[{"href":"mailto:support@cal.id","label":"Email Us"}],"primary":{"type":"button","label":"Go to Cal ID","href":"https://cal.id"}},"footer":{"socials":{"x":"https://x.com/OneHash","linkedin":"https://www.linkedin.com/company/onehash"}},"errors":{"404":{"redirect":false,"title":"We couldn't find that page","description":"The page you're looking for doesn't exist or may have moved. Head back to the [Help Center home](/), or jump to [Event Types](/event-types/overview), [Availability](/availability/create), [Teams](/teams/overview), or the [API Reference](/api-reference) — or use the search bar above. Still stuck? Email us at [support@cal.id](mailto:support@cal.id)."}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode","download-spec"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"cal-id-docs","hasAudioNarration":false,"actualSubdomain":"cal-id-docs","customDomains":["cal.id"],"gitSource":{"type":"github","owner":"onehashai","repo":"mintlify-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"latestBuiltDeploymentHistoryId":"6ab916db4c0abff9c16e8c99","collectionId":"a1537af2-6a4a-409a-a4fe-70a6408ebcf7","liveDeploymentHistoryId":"6ab916db4c0abff9c16e8c99","schemaVersion":"v3"},"feedback":{"thumbs":true,"agentFeedback":false},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ab916db4c0abff9c16e8c99","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"API Reference","count":60},{"language":"default","tag":"Endpoints","count":58},{"language":"default","tag":"Event Types","count":57},{"language":"default","tag":"Scheduling \u0026 Teams","count":31},{"language":"default","tag":"Get Started","count":31},{"language":"default","tag":"Customization \u0026 Settings","count":23},{"language":"default","tag":"Apps \u0026 Integrations","count":22},{"language":"default","tag":"Advanced","count":18},{"language":"default","tag":"Developers","count":17},{"language":"default","tag":"Teams","count":16}],"searchSettings":{"isFiltersEnabled":false}},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":true,"enableContextualStarterQuestions":true,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"support@cal.id"}},"basePath":"/docs","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"privacy":{"consentBanner":{"enabled":false}},"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"developers/api-key","slug":"/developers/api-key","pageMetadata":{"title":"How to Get Your Cal ID API Key","sidebarTitle":"API Keys","description":"Create, secure, and rotate a Cal ID API key so you can connect your scheduling data to external applications and authenticate REST API requests.","icon":"key","keywords":["api key","generate api key","authentication","api token","developer key"],"related":["/developers/api-integration","/developers/webhooks","/developers/event-type-id","/apps/make"],"href":"/developers/api-key"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Create, secure, and rotate a Cal ID API key so you can connect your scheduling data to external applications and authenticate REST API requests.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Card,CardGroup,CodeBlock,Frame,Heading,Note,OptimizedImage,Step,Steps,Tab,Tabs,Tip,Warning}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Tab)_missingMdxReference(`Tab`,true);if(!Tabs)_missingMdxReference(`Tabs`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`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.`}),`\n`,_jsx(Heading,{level:`2`,id:`create-your-api-key`,children:`Create your API key`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Open the developer dashboard`,children:[_jsxs(_components.p,{children:[`Log in to your `,_jsx(_components.strong,{children:`Cal ID`}),` account, click `,_jsx(_components.strong,{children:`Settings`}),`, then scroll the left sidebar to the `,_jsx(_components.strong,{children:`Developer`}),` section and click `,_jsx(_components.strong,{children:`API Keys`}),`.`]}),_jsx(Frame,{caption:`Finding where your keys are managed`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cal-id-docs/daiEdthULmsjrisX/images/developers/api-key-1.png?fit=max\u0026auto=format\u0026n=daiEdthULmsjrisX\u0026q=85\u0026s=7aea60d8e291e5763415bc92c2c7b7e2`,alt:`API Keys page under Settings → Developer, listing existing keys beside a Create an API Key button`,\"data-og-width\":`2400`,width:`2400`,\"data-og-height\":`1800`,height:`1800`,\"data-path\":`images/developers/api-key-1.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cal-id-docs/daiEdthULmsjrisX/images/developers/api-key-1.png?w=280\u0026fit=max\u0026auto=format\u0026n=daiEdthULmsjrisX\u0026q=85\u0026s=0759acbfe68ba6e610d5b88e79fed7a6 280w, https://mintcdn.com/cal-id-docs/daiEdthULmsjrisX/images/developers/api-key-1.png?w=560\u0026fit=max\u0026auto=format\u0026n=daiEdthULmsjrisX\u0026q=85\u0026s=f2fb59173bad858ddf4b846cc04ad1c2 560w, https://mintcdn.com/cal-id-docs/daiEdthULmsjrisX/images/developers/api-key-1.png?w=840\u0026fit=max\u0026auto=format\u0026n=daiEdthULmsjrisX\u0026q=85\u0026s=4e640d68ec91fcbeb65a51ebfcddf37b 840w, https://mintcdn.com/cal-id-docs/daiEdthULmsjrisX/images/developers/api-key-1.png?w=1100\u0026fit=max\u0026auto=format\u0026n=daiEdthULmsjrisX\u0026q=85\u0026s=e3d14748c935e20db80862324cb3e0b2 1100w, https://mintcdn.com/cal-id-docs/daiEdthULmsjrisX/images/developers/api-key-1.png?w=1650\u0026fit=max\u0026auto=format\u0026n=daiEdthULmsjrisX\u0026q=85\u0026s=e99008e92bc3a06132e87366278600ad 1650w, https://mintcdn.com/cal-id-docs/daiEdthULmsjrisX/images/developers/api-key-1.png?w=2500\u0026fit=max\u0026auto=format\u0026n=daiEdthULmsjrisX\u0026q=85\u0026s=2e6404801e22e8b1ca985174a6ec0ec9 2500w`})})]}),_jsx(Step,{title:`Start a new key`,children:_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Create an API Key`}),` in the top-right corner of the `,_jsx(_components.strong,{children:`API Keys`}),` page. A configuration window appears.`]})}),_jsx(Step,{title:`Name the key`,children:_jsxs(_components.p,{children:[`Enter a descriptive name in the `,_jsx(_components.strong,{children:`Name this key`}),` field — for example, “My Personal Portfolio” or “Zapier Integration.” A clear name helps you identify later which app uses which key.`]})}),_jsxs(Step,{title:`Set an expiration`,children:[_jsx(_components.p,{children:`Decide how long the key stays active.`}),_jsxs(Tabs,{children:[_jsx(Tab,{title:`Never expires`,id:`never-expires`,children:_jsxs(_components.p,{children:[`Switch the `,_jsx(_components.strong,{children:`Never expires`}),` toggle `,_jsx(_components.strong,{children:`ON`}),`. The key stays active until you manually delete it.`]})}),_jsxs(Tab,{title:`Set an expiry date`,id:`set-an-expiry-date`,children:[_jsxs(_components.p,{children:[`Leave the toggle `,_jsx(_components.strong,{children:`OFF`}),`, open the `,_jsx(_components.strong,{children:`Expiration date`}),` dropdown, and choose `,_jsx(_components.strong,{children:`7 days`}),`, `,_jsx(_components.strong,{children:`30 days`}),`, `,_jsx(_components.strong,{children:`3 months`}),`, or `,_jsx(_components.strong,{children:`1 year`}),`.`]}),_jsx(Note,{children:_jsx(_components.p,{children:`Once this date passes, the key expires and the integration stops working until you create a new one.`})})]})]})]}),_jsxs(Step,{title:`Create and copy the key`,children:[_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Create`}),`. Your secret key is shown `,_jsx(_components.strong,{children:`once`}),` — click the copy icon and paste it somewhere safe, like a password manager.`]}),_jsx(Warning,{children:_jsxs(_components.p,{children:[`For your protection, `,_jsx(_components.strong,{children:`Cal ID will never show this key again.`}),` If you close the window without copying it, delete the entry and create a new one.`]})})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`make-your-first-request`,children:`Make your first request`}),`\n`,_jsxs(_components.p,{children:[`Send an authenticated request to the `,_jsx(_components.code,{children:`me`}),` endpoint to confirm your key works — it returns your profile details.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`GET https://api.cal.id/users/me`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsxs(_components.p,{children:[`Here’s the same call with `,_jsx(_components.code,{children:`curl`}),`:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`4`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`4`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'GET'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'https://api.cal.id/users/me'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'accept: application/json'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Authorization: Bearer calid_XXXXXX'`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Replace `,_jsx(_components.code,{children:`calid_XXXXXX`}),` with your API key.`]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`Prefer to explore interactively? Open the `,_jsx(_components.a,{href:`/api-reference/introduction`,children:`API Reference`}),`, click `,_jsx(_components.strong,{children:`Authorize`}),`, paste your key, and run any endpoint against your live account right from the docs.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`key-security-rules`,children:`Key security rules`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Never share`}),` your API key in emails, chat messages, or public code repositories like GitHub.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Use separate keys`}),` for different integrations — safer than reusing one key everywhere.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Revoke unused keys`}),` from the `,_jsx(_components.strong,{children:`API Keys`}),` page with the `,_jsx(_components.strong,{children:`Delete`}),` (trash) icon to cut off access instantly.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`watch-your-call-volume`,children:`Watch your call volume`}),`\n`,_jsxs(_components.p,{children:[`Every response returned for your key carries `,_jsx(_components.code,{children:`X-RateLimit-Limit`}),`, `,_jsx(_components.code,{children:`X-RateLimit-Remaining`}),`, and `,_jsx(_components.code,{children:`X-RateLimit-Reset`}),` headers, and Cal ID answers with `,_jsx(_components.strong,{children:`429 Too Many Requests`}),` once you run out of allowance. Read `,_jsx(_components.a,{href:`/developers/rate-limits`,children:`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.`]}),`\n`,_jsx(Heading,{level:`2`,id:`start-using-your-key`,children:`Start using your key`}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`Explore the API Reference`,icon:`code`,href:`/api-reference/introduction`,children:_jsx(_components.p,{children:`Authorize once, then try every endpoint against your live account.`})}),_jsx(Card,{title:`Create your first booking`,icon:`calendar-plus`,href:`/developers/guides/create-a-booking`,children:_jsx(_components.p,{children:`A step-by-step recipe for booking through the API.`})}),_jsx(Card,{title:`API rate limits`,icon:`gauge-high`,href:`/developers/rate-limits`,children:_jsxs(_components.p,{children:[`Read the rate-limit headers and back off cleanly from a `,_jsx(_components.code,{children:`429`}),`.`]})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"How to Get Your Cal ID API Key","sidebarTitle":"API Keys","description":"Create, secure, and rotate a Cal ID API key so you can connect your scheduling data to external applications and authenticate REST API requests.","icon":"key","keywords":["api key","generate api key","authentication","api token","developer key"],"related":["/developers/api-integration","/developers/webhooks","/developers/event-type-id","/apps/make"],"href":"/developers/api-key"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Create your API key","slug":"create-your-api-key","depth":2,"children":[]},{"title":"Make your first request","slug":"make-your-first-request","depth":2,"children":[]},{"title":"Key security rules","slug":"key-security-rules","depth":2,"children":[]},{"title":"Watch your call volume","slug":"watch-your-call-volume","depth":2,"children":[]},{"title":"Start using your key","slug":"start-using-your-key","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/cal-id-docs/09b4d95490dd9c71/support-crisp.js"],"subdomain":"cal-id-docs","siteName":"Cal ID","title":"How to Get Your Cal ID API Key - Cal ID","relatedPages":[{"title":"Cal ID API Integration","link":"/developers/api-integration","icon":"plug"},{"title":"Cal ID Webhooks","link":"/developers/webhooks","icon":"webhook"},{"title":"How to Find Your Event Type ID","link":"/developers/event-type-id","icon":"hashtag"},{"title":"Integrate Cal ID with Make","link":"/apps/make","icon":"plug"}],"relatedPagesConfig":{"enabled":true,"limit":5,"mode":"automatic"},"contextualStarterQuestions":[{"_id":"6a9862a3cabf01e77694fe32","deploymentId":"6a6c20ecc3064aa95c02d1fd","questionText":"How do I rotate my API key?","status":"active","generatedBy":"contextual","path":"developers/api-key","createdAt":"2026-09-02T17:53:39.319Z","updatedAt":"2026-09-02T17:53:39.319Z","__v":0},{"_id":"6a9862a3cabf01e77694fe30","deploymentId":"6a6c20ecc3064aa95c02d1fd","questionText":"How do I create an API key?","status":"active","generatedBy":"contextual","path":"developers/api-key","createdAt":"2026-09-02T17:53:39.319Z","updatedAt":"2026-09-02T17:53:39.319Z","__v":0},{"_id":"6a9862a3cabf01e77694fe31","deploymentId":"6a6c20ecc3064aa95c02d1fd","questionText":"Where do I find my API keys?","status":"active","generatedBy":"contextual","path":"developers/api-key","createdAt":"2026-09-02T17:53:39.319Z","updatedAt":"2026-09-02T17:53:39.319Z","__v":0}],"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-02T17:53:02.558Z","originalFileLocation":"developers/api-key.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Create, secure, and rotate a Cal ID API key so you can connect your scheduling data to external applications and authenticate REST API requests.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Cal ID\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/cal-id-docs/Ah-PiVKdxwxdJ_gr/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/cal-id-docs/Ah-PiVKdxwxdJ_gr/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/cal-id-docs/Ah-PiVKdxwxdJ_gr/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/cal-id-docs/Ah-PiVKdxwxdJ_gr/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/cal-id-docs/Ah-PiVKdxwxdJ_gr/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/cal-id-docs/Ah-PiVKdxwxdJ_gr/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/cal-id-docs/Ah-PiVKdxwxdJ_gr/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/cal-id-docs/Ah-PiVKdxwxdJ_gr/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/cal-id-docs/Ah-PiVKdxwxdJ_gr/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"How to Get Your Cal ID API Key - Cal ID\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create, secure, and rotate a Cal ID API key so you can connect your scheduling data to external applications and authenticate REST API requests.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Cal ID\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://cal.id/docs/developers/api-key\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://cal-id-docs.mintlify.app/_mintlify/api/og/v2?division=Get+started\u0026amp;title=How+to+Get+Your+Cal+ID+API+Key\u0026amp;description=Create%2C+secure%2C+and+rotate+a+Cal+ID+API+key+so+you+can+connect+your+scheduling+data+to+external+applications+and+authenticate+REST+API+requests.\u0026amp;theme=1ce1fba1bcc16a5579de1fe3\u0026amp;signature=2299d5114a793db05747464562d48b7edeb1e4ecabd3e88fafbdc9285cd5fa47\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"How to Get Your Cal ID API Key - Cal ID\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create, secure, and rotate a Cal ID API key so you can connect your scheduling data to external applications and authenticate REST API requests.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://cal-id-docs.mintlify.app/_mintlify/api/og/v2?division=Get+started\u0026amp;title=How+to+Get+Your+Cal+ID+API+Key\u0026amp;description=Create%2C+secure%2C+and+rotate+a+Cal+ID+API+key+so+you+can+connect+your+scheduling+data+to+external+applications+and+authenticate+REST+API+requests.\u0026amp;theme=1ce1fba1bcc16a5579de1fe3\u0026amp;signature=2299d5114a793db05747464562d48b7edeb1e4ecabd3e88fafbdc9285cd5fa47\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/cal-id-docs/Ah-PiVKdxwxdJ_gr/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Cal ID\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1972F5\">\u003clink data-mint-head rel=\"canonical\" href=\"https://cal.id/docs/developers/api-key\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/developers/api-key.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://cal.id/#organization\",\"name\":\"Cal ID\",\"url\":\"https://cal.id\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/cal-id-docs/k1VHQ7P5ONAHeLvP/logo/light.svg?fit=max\u0026auto=format\u0026n=k1VHQ7P5ONAHeLvP\u0026q=85\u0026s=589c4a9c69ea7387516e6452f592553e\"}},{\"@type\":\"WebSite\",\"@id\":\"https://cal.id/docs#website\",\"name\":\"Cal ID\",\"url\":\"https://cal.id/docs\",\"publisher\":{\"@id\":\"https://cal.id/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://cal.id/docs/developers/api-key#webpage\",\"url\":\"https://cal.id/docs/developers/api-key\",\"name\":\"How to Get Your Cal ID API Key\",\"description\":\"Create, secure, and rotate a Cal ID API key so you can connect your scheduling data to external applications and authenticate REST API requests.\",\"dateModified\":\"2026-09-02T17:53:02.558Z\",\"isPartOf\":{\"@id\":\"https://cal.id/docs#website\"},\"breadcrumb\":{\"@id\":\"https://cal.id/docs/developers/api-key#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://cal.id/docs/developers/api-key#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Get started\",\"item\":\"https://cal.id/docs/developers/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"How to Get Your Cal ID API Key\",\"item\":\"https://cal.id/docs/developers/api-key\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://cal.id/docs/developers/api-key#article\",\"headline\":\"How to Get Your Cal ID API Key\",\"name\":\"How to Get Your Cal ID API Key\",\"description\":\"Create, secure, and rotate a Cal ID API key so you can connect your scheduling data to external applications and authenticate REST API requests.\",\"url\":\"https://cal.id/docs/developers/api-key\",\"mainEntityOfPage\":{\"@id\":\"https://cal.id/docs/developers/api-key#webpage\"},\"dateModified\":\"2026-09-02T17:53:02.558Z\",\"keywords\":\"api key, generate api key, authentication, api token, developer key\",\"publisher\":{\"@id\":\"https://cal.id/#organization\"},\"isPartOf\":{\"@id\":\"https://cal.id/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Cal ID\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Cal ID","nav":{"global":null,"tabs":[{"tab":"Get Started","pages":[{"title":"Get Started","href":""}]},{"tab":"Event Types","pages":[{"title":"Event Types","href":"/event-types/overview"}]},{"tab":"Scheduling \u0026 Teams","pages":[{"title":"Scheduling \u0026 Teams","href":"/scheduling/overview"}]},{"tab":"Apps \u0026 Integrations","pages":[{"title":"Apps \u0026 Integrations","href":"/apps/overview"}]},{"tab":"Customization \u0026 Settings","pages":[{"title":"Customization \u0026 Settings","href":"/customization/overview"}]},{"tab":"Developers","groups":[{"group":"Get started","pages":[{"title":"Cal ID Developer Documentation","sidebarTitle":"Overview","description":"Build scheduling into your own products with the Cal ID REST API — keys, guides, webhooks, and the full endpoint reference.","icon":"code","href":"/developers/overview"},{"title":"How to Get Your Cal ID API Key","sidebarTitle":"API Keys","icon":"key","href":"/developers/api-key"},{"title":"Cal ID API Quickstart","sidebarTitle":"Quickstart","description":"Go from a fresh Cal ID API key to a confirmed booking in five requests — authenticate, find an event type, fetch real slots, and book one of them.","icon":"rocket","href":"/developers/quickstart"},{"title":"Cal ID API Integration","sidebarTitle":"API Integration","icon":"plug","href":"/developers/api-integration"},{"title":"Cal ID API Rate Limits","sidebarTitle":"Rate Limits","icon":"gauge-high","href":"/developers/rate-limits"},{"title":"Cal ID API Error Codes","sidebarTitle":"Error Codes","icon":"triangle-exclamation","href":"/developers/error-codes"},{"title":"How to Find Your Event Type ID","sidebarTitle":"Event Type ID","icon":"hashtag","href":"/developers/event-type-id"},{"title":"Cal ID Webhooks","sidebarTitle":"Webhooks","icon":"webhook","href":"/developers/webhooks"}]},{"group":"Guides","pages":[{"title":"Book a Meeting with the Cal ID API","sidebarTitle":"Create a booking","icon":"calendar-check","href":"/developers/guides/create-a-booking"},{"title":"Reserve a slot before booking","icon":"lock","href":"/developers/guides/reserve-a-slot"},{"title":"Reschedule and cancel bookings","icon":"calendar-xmark","href":"/developers/guides/reschedule-and-cancel"},{"title":"List and filter bookings","icon":"list","href":"/developers/guides/list-and-filter-bookings"},{"title":"Manage event types","icon":"calendar","href":"/developers/guides/manage-event-types"},{"title":"Manage availability schedules","icon":"clock","href":"/developers/guides/manage-schedules"},{"title":"Manage team members","icon":"users","href":"/developers/guides/manage-team-members"},{"title":"Work with contacts","icon":"address-book","href":"/developers/guides/work-with-contacts"},{"title":"Build a webhook receiver","icon":"webhook","href":"/developers/guides/webhook-receiver"}]}]},{"tab":"MCP","icon":"plug","pages":[{"title":"MCP","href":"/mcp/overview"}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/introduction"}]}]},"basePath":"","title":"How to Get Your Cal ID API Key - Cal ID","buildId":"dpl_6cCEiK8XNNvaLBBkWzcBhdE9QfLC","deploymentId":"dpl_6cCEiK8XNNvaLBBkWzcBhdE9QfLC","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-Bj1PpgeO.js","DynamicMarkdown-Bas9A7wq.js","zoom-image-lightbox-B-WKhCOL.js","lightbox-handle-r17bVUz3.js"]}