Choose scoped account credentials, workspace OAuth tokens, or workspace API keys.
For workspace agent discovery and chat integrations, use the OAuth 2.0 client-credentials flow. Account management operations use a separate account credential, described below. When you create a workspace key in Communicate, save both values shown once:
Client ID — the key ID.
Client secret — the ck_ secret.
The canonical OpenAPI 3.2.1 contract
describes token exchange with HTTP Basic authentication: client ID as username and
client secret as password. Send these credentials when requesting a token; an access
token is not required for that exchange.
Requested scopes must be a subset of the permissions selected when the key was created. Revoking or narrowing the source key takes effect immediately, including for access tokens already issued.Access tokens are resource-bound. REST tokens default to https://app.communicate.so/api/v1. To connect an MCP client, request a separate token for https://app.communicate.so/mcp as shown in Connect with MCP. REST tokens cannot call MCP, and MCP tokens cannot call REST.
Direct API keys
Existing integrations can continue using the ck_ secret directly. Its effective permissions are the key’s complete scope set.
Authorization: Bearer ck_your_key
Treat API keys as server-side secrets. Do not place them in browser code, mobile apps, public repositories, logs, or URLs.
Keys are workspace-bound. A credential can access only agents in its workspace, and revoked keys stop working immediately.Direct ck_ keys are accepted only by the REST API. MCP accepts resource-bound workspace OAuth tokens for read-only agent discovery, or explicitly MCP-bound account credentials for scoped management.Missing and invalid bearer credentials return 401 with a WWW-Authenticate challenge and a structured JSON error.
{ "error": "Missing API key", "code": "api_key_missing"}
Account management credentials
Account credentials use the ca_ prefix and authorize supported account, workspace,
member, team, agent, source, learning, Grill and personal-notification management
operations. A workspace OAuth token or ck_ key does not grant these account scopes.
Each operation’s API reference declares its required credential and scope.Verified email/password users can obtain an account credential without a browser
session using POST /account-credentials/bootstrap or the
CLI bootstrap command. Use the request
schema in the API reference and request only the scopes needed by your workflow.Account credentials expire within 24 hours and cannot outlive their issuer session.
Every request checks current user, credential, membership, role and entitlement.
Revocation, expiry and scope narrowing take effect on subsequent authorization checks.
Account credentials default to the REST audience https://app.communicate.so/api/v1. To use MCP management, explicitly request "audience": "https://app.communicate.so/mcp" during bootstrap or creation. REST-bound account credentials cannot call MCP, and MCP-bound account credentials cannot call REST. Rotation preserves the existing audience.Credential creation, editing, rotation and revocation require fresh password proof
and credentials:write; listing requires credentials:read. A machine caller cannot
issue or rotate into broader authority or a longer lifetime. Save one-time secrets
only in protected files or your secret manager. Native browser-session writes retain
their Origin protection.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Communicate Developer","description":"Public API and agent integration documentation for Communicate.","colors":{"primary":"#1E1E1E","light":"#383838","dark":"#E4E0DE"},"logo":{"light":"https://mintcdn.com/communicate/HZS4zfNdwx6GDDQB/images/communicate-light.svg?fit=max\u0026auto=format\u0026n=HZS4zfNdwx6GDDQB\u0026q=85\u0026s=e0304d25a479975be74d31eab2230279","dark":"https://mintcdn.com/communicate/HZS4zfNdwx6GDDQB/images/communicate-dark.svg?fit=max\u0026auto=format\u0026n=HZS4zfNdwx6GDDQB\u0026q=85\u0026s=c03bf70698b8b0b7a78309d011a1132d","href":"https://communicate.so"},"favicon":"https://mintcdn.com/communicate/YtYK-i3qSnVKGPlI/images/communicate-icon.svg?fit=max\u0026auto=format\u0026n=YtYK-i3qSnVKGPlI\u0026q=85\u0026s=44346a3c1d255b01b21cb195acfc632e","api":{"openapi":"https://app.communicate.so/api/v1/openapi/mintlify.json","playground":{"display":"interactive","proxy":true},"examples":{"defaults":"required","languages":["curl","javascript","python"],"autogenerate":true}},"appearance":{"default":"system","strict":false},"navbar":{"links":[{"href":"https://communicate.so","label":"Website"},{"href":"https://github.com/communicateso/docs","label":"GitHub"}],"primary":{"type":"button","label":"Open Communicate","href":"https://app.communicate.so"}},"footer":{"socials":{"github":"https://github.com/communicateso"}},"search":{"prompt":"Ask about Communicate API endpoints, authentication, errors, or agent workflows."},"seo":{"metatags":{"keywords":"Communicate API, customer support agents, MCP, AI agents"},"indexing":"navigable"},"contextual":{"options":["copy","view","chatgpt","claude","mcp"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"communicate","hasAudioNarration":false,"actualSubdomain":"communicate","customDomains":["developer.communicate.so"],"gitSource":{"type":"github","owner":"communicateso","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6ac5245f469bc277fbf5e9ad","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API Reference","count":215},{"language":"default","tag":"Agents","count":68},{"language":"default","tag":"Workspaces","count":66},{"language":"default","tag":"Inbox","count":18},{"language":"default","tag":"Sources","count":15},{"language":"default","tag":"Notifications","count":11},{"language":"default","tag":"Workspace members","count":9},{"language":"default","tag":"Documentation","count":8},{"language":"default","tag":"Start","count":8},{"language":"default","tag":"Grill","count":8}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"html{scrollbar-gutter:stable}@supports not (scrollbar-gutter: stable){html{overflow-y:scroll}}a.group[href=\"https://app.communicate.so\"]>.bg-primary-dark{background-color:#274387}.nav-logo{min-width:154px}a:has(>.nav-logo)::after{content:\"v0.1.5\";display:block;margin-top:3px;color:#525252;font-size:11px;font-weight:500;line-height:14px;text-align:left}.dark a:has(>.nav-logo)::after{color:#a3a3a3}"}]}
{"page":{"pagePath":"docs/authentication","slug":"/docs/authentication","pageMetadata":{"title":"Authentication","description":"Choose scoped account credentials, workspace OAuth tokens, or workspace API keys.","href":"/docs/authentication"},"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: \"Choose scoped account credentials, workspace OAuth tokens, or workspace API keys.\"\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`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`For workspace agent discovery and chat integrations, use the OAuth 2.0 client-credentials flow. Account management operations use a separate account credential, described below. When you create a workspace key in Communicate, save both values shown once:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Client ID`}),` — the key ID.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Client secret`}),` — the `,_jsx(_components.code,{children:`ck_`}),` secret.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`The `,_jsx(_components.a,{href:`https://app.communicate.so/api/v1/openapi.json`,children:`canonical OpenAPI 3.2.1 contract`}),`\ndescribes token exchange with HTTP Basic authentication: client ID as username and\nclient secret as password. Send these credentials when requesting a token; an access\ntoken is not required for that exchange.`]}),`\n`,_jsx(Heading,{level:`2`,id:`request-an-access-token`,children:`Request an access token`}),`\n`,_jsx(_components.p,{children:`Choose the smallest scopes the integration needs:`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Scope`}),_jsx(_components.th,{children:`Permission`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`agents:read`})}),_jsx(_components.td,{children:`List agents in the workspace`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`chat:write`})}),_jsx(_components.td,{children:`Send chat turns to workspace agents`})]})]})]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`7`,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:`7`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`export`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` COMMUNICATE_CLIENT_ID`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"your_key_id\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`export`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` COMMUNICATE_CLIENT_SECRET`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"ck_your_secret\"`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_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:` -u`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$COMMUNICATE_CLIENT_ID`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$COMMUNICATE_CLIENT_SECRET`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_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://app.communicate.so/api/v1/oauth/token`}),_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:` \"Content-Type: application/x-www-form-urlencoded\"`}),_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:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"grant_type=client_credentials\u0026scope=agents%3Aread\"`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`The response contains a bearer token valid for one hour:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`6`,language:`json`,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:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`6`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"access_token\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"eyJ...\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"token_type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Bearer\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"expires_in\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`3600`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"scope\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"agents:read\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Use the access token on API requests:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`http`,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:`http`,children:_jsxs(_components.code,{language:`http`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`Authorization`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` Bearer your_access_token`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Requested scopes must be a subset of the permissions selected when the key was created. Revoking or narrowing the source key takes effect immediately, including for access tokens already issued.`}),`\n`,_jsxs(_components.p,{children:[`Access tokens are resource-bound. REST tokens default to `,_jsx(_components.code,{children:`https://app.communicate.so/api/v1`}),`. To connect an MCP client, request a separate token for `,_jsx(_components.code,{children:`https://app.communicate.so/mcp`}),` as shown in `,_jsx(_components.a,{href:`/docs/mcp`,children:`Connect with MCP`}),`. REST tokens cannot call MCP, and MCP tokens cannot call REST.`]}),`\n`,_jsx(Heading,{level:`2`,id:`direct-api-keys`,children:`Direct API keys`}),`\n`,_jsxs(_components.p,{children:[`Existing integrations can continue using the `,_jsx(_components.code,{children:`ck_`}),` secret directly. Its effective permissions are the key’s complete scope set.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`http`,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:`http`,children:_jsxs(_components.code,{language:`http`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`Authorization`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` Bearer ck_your_key`})]}),`\n`]})})}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Treat API keys as server-side secrets. Do not place them in browser code, mobile apps, public repositories, logs, or URLs.`})}),`\n`,_jsx(_components.p,{children:`Keys are workspace-bound. A credential can access only agents in its workspace, and revoked keys stop working immediately.`}),`\n`,_jsxs(_components.p,{children:[`Direct `,_jsx(_components.code,{children:`ck_`}),` keys are accepted only by the REST API. MCP accepts resource-bound workspace OAuth tokens for read-only agent discovery, or explicitly MCP-bound account credentials for scoped management.`]}),`\n`,_jsxs(_components.p,{children:[`Missing and invalid bearer credentials return `,_jsx(_components.code,{children:`401`}),` with a `,_jsx(_components.code,{children:`WWW-Authenticate`}),` challenge and a structured JSON error.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`4`,language:`json`,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:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`4`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Missing API key\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"api_key_missing\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`account-management-credentials`,children:`Account management credentials`}),`\n`,_jsxs(_components.p,{children:[`Account credentials use the `,_jsx(_components.code,{children:`ca_`}),` prefix and authorize supported account, workspace,\nmember, team, agent, source, learning, Grill and personal-notification management\noperations. A workspace OAuth token or `,_jsx(_components.code,{children:`ck_`}),` key does not grant these account scopes.\nEach operation’s API reference declares its required credential and scope.`]}),`\n`,_jsxs(_components.p,{children:[`Verified email/password users can obtain an account credential without a browser\nsession using `,_jsx(_components.code,{children:`POST /account-credentials/bootstrap`}),` or the\n`,_jsx(_components.a,{href:`/docs/cli#authenticate-without-a-browser`,children:`CLI bootstrap command`}),`. Use the request\nschema in the API reference and request only the scopes needed by your workflow.`]}),`\n`,_jsxs(_components.p,{children:[`Account credentials expire within 24 hours and cannot outlive their issuer session.\nEvery request checks current user, credential, membership, role and entitlement.\nRevocation, expiry and scope narrowing take effect on subsequent authorization checks.\nAccount credentials default to the REST audience `,_jsx(_components.code,{children:`https://app.communicate.so/api/v1`}),`. To use MCP management, explicitly request `,_jsx(_components.code,{children:`\"audience\": \"https://app.communicate.so/mcp\"`}),` during bootstrap or creation. REST-bound account credentials cannot call MCP, and MCP-bound account credentials cannot call REST. Rotation preserves the existing audience.`]}),`\n`,_jsxs(_components.p,{children:[`Credential creation, editing, rotation and revocation require fresh password proof\nand `,_jsx(_components.code,{children:`credentials:write`}),`; listing requires `,_jsx(_components.code,{children:`credentials:read`}),`. A machine caller cannot\nissue or rotate into broader authority or a longer lifetime. Save one-time secrets\nonly in protected files or your secret manager. Native browser-session writes retain\ntheir Origin protection.`]})]})}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":"Authentication","description":"Choose scoped account credentials, workspace OAuth tokens, or workspace API keys.","href":"/docs/authentication"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Request an access token","slug":"request-an-access-token","depth":2,"children":[]},{"title":"Direct API keys","slug":"direct-api-keys","depth":2,"children":[]},{"title":"Account management credentials","slug":"account-management-credentials","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"communicate","siteName":"Communicate Developer","title":"Authentication - Communicate Developer","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-03T08:13:52.780Z","originalFileLocation":"docs/authentication.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=\"Choose scoped account credentials, workspace OAuth tokens, or workspace API keys.\">\u003cmeta data-mint-head name=\"keywords\" content=\"Communicate API, customer support agents, MCP, AI agents\">\u003cmeta data-mint-head name=\"application-name\" content=\"Communicate Developer\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/communicate/SZzXqSL4q_3hLUb5/_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=\"/mintlify-assets/_mintlify/favicons/communicate/SZzXqSL4q_3hLUb5/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/communicate/SZzXqSL4q_3hLUb5/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/communicate/SZzXqSL4q_3hLUb5/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/communicate/SZzXqSL4q_3hLUb5/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/communicate/SZzXqSL4q_3hLUb5/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/communicate/SZzXqSL4q_3hLUb5/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/communicate/SZzXqSL4q_3hLUb5/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/communicate/SZzXqSL4q_3hLUb5/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Authentication - Communicate Developer\">\u003cmeta data-mint-head property=\"og:description\" content=\"Choose scoped account credentials, workspace OAuth tokens, or workspace API keys.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Communicate Developer\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developer.communicate.so/docs/authentication\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://communicate.mintlify.site/_mintlify/api/og/v2?division=Start\u0026amp;title=Authentication\u0026amp;description=Choose+scoped+account+credentials%2C+workspace+OAuth+tokens%2C+or+workspace+API+keys.\u0026amp;theme=06fae84050287f8ed5c9b8ae\u0026amp;signature=5df4ac99db2bf6ee4ebd6e7d457ea1a98e19f130d0c378a7947911be4e882a0f\">\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=\"Authentication - Communicate Developer\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Choose scoped account credentials, workspace OAuth tokens, or workspace API keys.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://communicate.mintlify.site/_mintlify/api/og/v2?division=Start\u0026amp;title=Authentication\u0026amp;description=Choose+scoped+account+credentials%2C+workspace+OAuth+tokens%2C+or+workspace+API+keys.\u0026amp;theme=06fae84050287f8ed5c9b8ae\u0026amp;signature=5df4ac99db2bf6ee4ebd6e7d457ea1a98e19f130d0c378a7947911be4e882a0f\">\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=\"/mintlify-assets/_mintlify/favicons/communicate/SZzXqSL4q_3hLUb5/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Communicate Developer\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1E1E1E\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developer.communicate.so/docs/authentication\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/authentication.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developer.communicate.so/#organization\",\"name\":\"Communicate Developer\",\"url\":\"https://developer.communicate.so\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/communicate/HZS4zfNdwx6GDDQB/images/communicate-light.svg?fit=max\u0026auto=format\u0026n=HZS4zfNdwx6GDDQB\u0026q=85\u0026s=e0304d25a479975be74d31eab2230279\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developer.communicate.so#website\",\"name\":\"Communicate Developer\",\"url\":\"https://developer.communicate.so\",\"publisher\":{\"@id\":\"https://developer.communicate.so/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developer.communicate.so/docs/authentication#webpage\",\"url\":\"https://developer.communicate.so/docs/authentication\",\"name\":\"Authentication\",\"description\":\"Choose scoped account credentials, workspace OAuth tokens, or workspace API keys.\",\"dateModified\":\"2026-10-03T08:13:52.780Z\",\"isPartOf\":{\"@id\":\"https://developer.communicate.so#website\"},\"breadcrumb\":{\"@id\":\"https://developer.communicate.so/docs/authentication#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developer.communicate.so/docs/authentication#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Start\",\"item\":\"https://developer.communicate.so/docs/introduction\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Authentication\",\"item\":\"https://developer.communicate.so/docs/authentication\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://developer.communicate.so/docs/authentication#article\",\"headline\":\"Authentication\",\"name\":\"Authentication\",\"description\":\"Choose scoped account credentials, workspace OAuth tokens, or workspace API keys.\",\"url\":\"https://developer.communicate.so/docs/authentication\",\"mainEntityOfPage\":{\"@id\":\"https://developer.communicate.so/docs/authentication#webpage\"},\"dateModified\":\"2026-10-03T08:13:52.780Z\",\"publisher\":{\"@id\":\"https://developer.communicate.so/#organization\"},\"isPartOf\":{\"@id\":\"https://developer.communicate.so#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Communicate Developer\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Communicate Developer\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/authentication.md","siteName":"Communicate Developer","nav":{"global":null,"tabs":[{"tab":"Documentation","icon":"book-open","groups":[{"group":"Start","pages":[{"title":"Communicate Developer Platform","href":"/docs/introduction"},{"title":"Workspace integration quickstart","description":"List an agent and send your first support question.","href":"/docs/quickstart"},{"title":"Authentication","href":"/docs/authentication"},{"title":"Errors","description":"Understand Communicate public API status codes and error bodies.","href":"/docs/errors"},{"title":"Rate Limits","href":"/docs/rate-limits"},{"title":"Idempotency","href":"/docs/idempotency"},{"title":"Safe Agent Workflows","href":"/docs/safe-agent-workflows"},{"title":"Changelog","href":"/docs/changelog"}]}]},{"tab":"API Reference","icon":"code","pages":[{"title":"API Reference","href":"/api-reference/account-credentials/obtain-an-account-credential-with-verified-email-and-password-proof"}]},{"tab":"CLI","icon":"terminal","pages":[{"title":"CLI","href":"/docs/cli"}]},{"tab":"MCP / Codex / Claude","icon":"bot","pages":[{"title":"MCP / Codex / Claude","href":"/agents/introduction"}]}]},"basePath":"","title":"Authentication - Communicate Developer","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":[],"chunks":[]}