Understand the two authentication methods: JWT and API tokens
Authentication
Oktivo uses two authentication methods depending on the context:
Method
Use Case
Format
JWT
Dashboard sessions, token management
Authorization: Bearer <jwt>
API Token
CRM integrations, programmatic calls
Authorization: Bearer okt_...
API Tokens
API tokens are designed for server-to-server integrations. They authenticate requests to the CRM API endpoints (/api/v1/crm/calls/*).
Token Format
All API tokens use the okt_ prefix followed by a random string:
okt_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6
The prefix makes tokens easy to identify in logs and secret scanners.
Creating a Token
From the dashboard: open Settings β API Tokens (app.oktivo.com/account),
click Create Token, name it, and pick an expiry. The panel lists each token
with its expiry and last-used date, and lets you rotate (β») or delete (π) it.
Each account can hold a maximum of 5 active tokens β delete an unused one to
free a slot.Via the API:
The plaintext token is returned exactly once in the response. Store it securely you cannot retrieve it again.
Token Expiry
Tokens expire after the configured expiresInDays (1β365 days). Expired tokens are automatically rejected. Plan to rotate tokens before they expire to avoid service interruptions.
Token Rotation
Rotate a token to invalidate the old value and get a new one in a single operation:
curl -X POST https://client-backend.oktivo.com/api/v1/crm/tokens/{tokenId}/rotate \ -H "Authorization: Bearer YOUR_JWT_TOKEN"
This returns a new plaintext token. The old token stops working immediately.
Using API Tokens
Include the token in the Authorization header for all CRM API requests:
Authorization: Bearer okt_your_token_here
Token Limits
Maximum name length: 128 characters
Expiry range: 1β365 days
Tokens can be soft-deleted (they stop working immediately but records are retained)
JWT Authentication
JWT tokens are issued when users log in through the Oktivo dashboard. They authenticate:
JWTs are managed automatically by the dashboard you donβt need to handle them for CRM integrations.
Which Should I Use?
Building a CRM integration? β Use an API token
Managing tokens or webhooks programmatically? β Use JWT from an authenticated session
Using the dashboard? β JWT is handled automatically
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Oktivo Voice Platform","colors":{"primary":"#6366F1","light":"#818CF8","dark":"#4F46E5"},"logo":{"light":"https://mintcdn.com/oktivo-stage-docs/c3bIROP6UAjDKw3o/logo/light.svg?fit=max\u0026auto=format\u0026n=c3bIROP6UAjDKw3o\u0026q=85\u0026s=1c98fac4d121323a27790697944c99b7","dark":"https://mintcdn.com/oktivo-stage-docs/c3bIROP6UAjDKw3o/logo/dark.svg?fit=max\u0026auto=format\u0026n=c3bIROP6UAjDKw3o\u0026q=85\u0026s=15f13a2059aaed381bcb0ce57887df79"},"favicon":"https://mintcdn.com/oktivo-stage-docs/c3bIROP6UAjDKw3o/favicon.svg?fit=max\u0026auto=format\u0026n=c3bIROP6UAjDKw3o\u0026q=85\u0026s=9c5dcbfa6a668979966a6d33ea53c9bc","api":{"mdx":{"auth":{"method":"bearer"},"server":"https://client-backend.oktivo.com"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"oktivo-stage-docs","hasAudioNarration":false,"actualSubdomain":"oktivo-stage-docs","customDomains":["stage-docs.oktivo.com"],"gitSource":{"type":"github","owner":"op-oktivo","repo":"oktivo-voice-app","deployBranch":"stage","contentDirectory":"documentation","isPrivate":true,"mountPath":"","label":"","_id":"6afc2692fb78305a65834b0e"},"entitlements":{},"buildId":"6afd789936e6bb5efca0aa76","clientVersion":"0.0.4177","searchFilterCounts":[{"language":"default","tag":"Documentation","count":15},{"language":"default","tag":"API Reference","count":14},{"language":"default","tag":"Webhooks","count":5},{"language":"default","tag":"Guides","count":5},{"language":"default","tag":"Authentication","count":4},{"language":"default","tag":"Core Concepts","count":4},{"language":"default","tag":"Calls","count":3},{"language":"default","tag":"Getting Started","count":3},{"language":"default","tag":"Connectors","count":3},{"language":"default","tag":"Leads","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","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":"rbac-expansion","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":"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":"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":"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":"editor-metadata","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},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"authentication","slug":"/authentication","pageMetadata":{"title":"Authentication","description":"Understand the two authentication methods: JWT and API tokens","href":"/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: \"Understand the two authentication methods: JWT and API tokens\"\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={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(Heading,{level:`1`,id:`authentication`,children:`Authentication`}),`\n`,_jsx(_components.p,{children:`Oktivo uses two authentication methods depending on the context:`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Method`}),_jsx(_components.th,{children:`Use Case`}),_jsx(_components.th,{children:`Format`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`JWT`})}),_jsx(_components.td,{children:`Dashboard sessions, token management`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Authorization: Bearer \u003cjwt>`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`API Token`})}),_jsx(_components.td,{children:`CRM integrations, programmatic calls`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Authorization: Bearer okt_...`})})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`api-tokens`,children:`API Tokens`}),`\n`,_jsxs(_components.p,{children:[`API tokens are designed for server-to-server integrations. They authenticate requests to the CRM API endpoints (`,_jsx(_components.code,{children:`/api/v1/crm/calls/*`}),`).`]}),`\n`,_jsx(Heading,{level:`3`,id:`token-format`,children:`Token Format`}),`\n`,_jsxs(_components.p,{children:[`All API tokens use the `,_jsx(_components.code,{children:`okt_`}),` prefix followed by a random string:`]}),`\n`,_jsx(CodeBlock,{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:`okt_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(_components.p,{children:`The prefix makes tokens easy to identify in logs and secret scanners.`}),`\n`,_jsx(Heading,{level:`3`,id:`creating-a-token`,children:`Creating a Token`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`From the dashboard:`}),` open `,_jsx(_components.strong,{children:`Settings β API Tokens`}),` (`,_jsx(_components.code,{children:`app.oktivo.com/account`}),`),\nclick `,_jsx(_components.strong,{children:`Create Token`}),`, name it, and pick an expiry. The panel lists each token\nwith its expiry and last-used date, and lets you rotate (β») or delete (π) it.\nEach account can hold a maximum of `,_jsx(_components.strong,{children:`5 active tokens`}),` β delete an unused one to\nfree a slot.`]}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Via the API:`})}),`\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:`#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:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://client-backend.oktivo.com/api/v1/crm/tokens`}),_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 YOUR_JWT_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/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:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"name\": \"salesforce-integration\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"expiresInDays\": 90`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`The plaintext token is returned `,_jsx(_components.strong,{children:`exactly once`}),` in the response. Store it securely you cannot retrieve it again.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`token-expiry`,children:`Token Expiry`}),`\n`,_jsxs(_components.p,{children:[`Tokens expire after the configured `,_jsx(_components.code,{children:`expiresInDays`}),` (1β365 days). Expired tokens are automatically rejected. Plan to rotate tokens before they expire to avoid service interruptions.`]}),`\n`,_jsx(Heading,{level:`3`,id:`token-rotation`,children:`Token Rotation`}),`\n`,_jsx(_components.p,{children:`Rotate a token to invalidate the old value and get a new one in a single operation:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,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:`2`,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:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://client-backend.oktivo.com/api/v1/crm/tokens/{tokenId}/rotate`}),_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 YOUR_JWT_TOKEN\"`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`This returns a new plaintext token. The old token stops working immediately.`}),`\n`,_jsx(Heading,{level:`3`,id:`using-api-tokens`,children:`Using API Tokens`}),`\n`,_jsxs(_components.p,{children:[`Include the token in the `,_jsx(_components.code,{children:`Authorization`}),` header for all CRM API requests:`]}),`\n`,_jsx(CodeBlock,{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:`Authorization: Bearer okt_your_token_here`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(Heading,{level:`3`,id:`token-limits`,children:`Token Limits`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Maximum name length: 128 characters`}),`\n`,_jsx(_components.li,{children:`Expiry range: 1β365 days`}),`\n`,_jsx(_components.li,{children:`Tokens can be soft-deleted (they stop working immediately but records are retained)`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`jwt-authentication`,children:`JWT Authentication`}),`\n`,_jsx(_components.p,{children:`JWT tokens are issued when users log in through the Oktivo dashboard. They authenticate:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Token management endpoints (`,_jsx(_components.code,{children:`/api/v1/crm/tokens/*`}),`)`]}),`\n`,_jsxs(_components.li,{children:[`Webhook management endpoints (`,_jsx(_components.code,{children:`/webhooks/endpoints/*`}),`)`]}),`\n`,_jsx(_components.li,{children:`Dashboard API calls`}),`\n`]}),`\n`,_jsx(_components.p,{children:`JWTs are managed automatically by the dashboard you donβt need to handle them for CRM integrations.`}),`\n`,_jsx(Heading,{level:`2`,id:`which-should-i-use`,children:`Which Should I Use?`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Building a CRM integration?`}),` β Use an API token`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Managing tokens or webhooks programmatically?`}),` β Use JWT from an authenticated session`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Using the dashboard?`}),` β JWT is handled automatically`]}),`\n`]})]})}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":"Understand the two authentication methods: JWT and API tokens","href":"/authentication"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Authentication","slug":"authentication","depth":1,"children":[]},{"title":"API Tokens","slug":"api-tokens","depth":2,"children":[{"title":"Token Format","slug":"token-format","depth":3,"children":[]},{"title":"Creating a Token","slug":"creating-a-token","depth":3,"children":[]},{"title":"Token Expiry","slug":"token-expiry","depth":3,"children":[]},{"title":"Token Rotation","slug":"token-rotation","depth":3,"children":[]},{"title":"Using API Tokens","slug":"using-api-tokens","depth":3,"children":[]},{"title":"Token Limits","slug":"token-limits","depth":3,"children":[]}]},{"title":"JWT Authentication","slug":"jwt-authentication","depth":2,"children":[]},{"title":"Which Should I Use?","slug":"which-should-i-use","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"oktivo-stage-docs","siteName":"Oktivo Voice Platform","title":"Authentication - Oktivo Voice Platform","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-17T10:08:20.806Z","originalFileLocation":"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=\"Understand the two authentication methods: JWT and API tokens\">\u003cmeta data-mint-head name=\"application-name\" content=\"Oktivo Voice Platform\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/oktivo-stage-docs/PnhsQUrQRukt15PE/_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/oktivo-stage-docs/PnhsQUrQRukt15PE/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/oktivo-stage-docs/PnhsQUrQRukt15PE/_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/oktivo-stage-docs/PnhsQUrQRukt15PE/_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/oktivo-stage-docs/PnhsQUrQRukt15PE/_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/oktivo-stage-docs/PnhsQUrQRukt15PE/_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/oktivo-stage-docs/PnhsQUrQRukt15PE/_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/oktivo-stage-docs/PnhsQUrQRukt15PE/_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/oktivo-stage-docs/PnhsQUrQRukt15PE/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Authentication - Oktivo Voice Platform\">\u003cmeta data-mint-head property=\"og:description\" content=\"Understand the two authentication methods: JWT and API tokens\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Oktivo Voice Platform\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://stage-docs.oktivo.com/authentication\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://oktivo-stage-docs.mintlify.site/_mintlify/api/og/v2?division=Getting+Started\u0026amp;title=Authentication\u0026amp;description=Understand+the+two+authentication+methods%3A+JWT+and+API+tokens\u0026amp;theme=cfcb37cdab6bd5c33dbe394c\u0026amp;signature=830ff9aae98549e3ad0df5990fbabf62d62eb799b9934219bde290f9edb237c1\">\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 - Oktivo Voice Platform\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Understand the two authentication methods: JWT and API tokens\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://oktivo-stage-docs.mintlify.site/_mintlify/api/og/v2?division=Getting+Started\u0026amp;title=Authentication\u0026amp;description=Understand+the+two+authentication+methods%3A+JWT+and+API+tokens\u0026amp;theme=cfcb37cdab6bd5c33dbe394c\u0026amp;signature=830ff9aae98549e3ad0df5990fbabf62d62eb799b9934219bde290f9edb237c1\">\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/oktivo-stage-docs/PnhsQUrQRukt15PE/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Oktivo Voice Platform\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6366F1\">\u003clink data-mint-head rel=\"canonical\" href=\"https://stage-docs.oktivo.com/authentication\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/authentication.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://stage-docs.oktivo.com/#organization\",\"name\":\"Oktivo Voice Platform\",\"url\":\"https://stage-docs.oktivo.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/oktivo-stage-docs/c3bIROP6UAjDKw3o/logo/light.svg?fit=max\u0026auto=format\u0026n=c3bIROP6UAjDKw3o\u0026q=85\u0026s=1c98fac4d121323a27790697944c99b7\"}},{\"@type\":\"WebSite\",\"@id\":\"https://stage-docs.oktivo.com#website\",\"name\":\"Oktivo Voice Platform\",\"url\":\"https://stage-docs.oktivo.com\",\"publisher\":{\"@id\":\"https://stage-docs.oktivo.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://stage-docs.oktivo.com/authentication#webpage\",\"url\":\"https://stage-docs.oktivo.com/authentication\",\"name\":\"Authentication\",\"description\":\"Understand the two authentication methods: JWT and API tokens\",\"dateModified\":\"2026-11-17T10:08:20.806Z\",\"isPartOf\":{\"@id\":\"https://stage-docs.oktivo.com#website\"},\"breadcrumb\":{\"@id\":\"https://stage-docs.oktivo.com/authentication#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://stage-docs.oktivo.com/authentication#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Getting Started\",\"item\":\"https://stage-docs.oktivo.com/introduction\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Authentication\",\"item\":\"https://stage-docs.oktivo.com/authentication\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://stage-docs.oktivo.com/authentication#article\",\"headline\":\"Authentication\",\"name\":\"Authentication\",\"description\":\"Understand the two authentication methods: JWT and API tokens\",\"url\":\"https://stage-docs.oktivo.com/authentication\",\"mainEntityOfPage\":{\"@id\":\"https://stage-docs.oktivo.com/authentication#webpage\"},\"dateModified\":\"2026-11-17T10:08:20.806Z\",\"publisher\":{\"@id\":\"https://stage-docs.oktivo.com/#organization\"},\"isPartOf\":{\"@id\":\"https://stage-docs.oktivo.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Oktivo Voice Platform\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Oktivo Voice Platform\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/authentication.md","siteName":"Oktivo Voice Platform","nav":{"global":null,"tabs":[{"tab":"Documentation","groups":[{"group":"Getting Started","pages":[{"title":"Introduction","href":"/introduction"},{"title":"Quickstart","description":"Go from zero to your first AI-powered call in under 5 minutes","href":"/quickstart"},{"title":"Authentication","href":"/authentication"}]},{"group":"Core Concepts","pages":[{"title":"Agents","description":"AI voice personas that handle conversations autonomously","href":"/concepts/agents"},{"title":"Campaigns","href":"/concepts/campaigns"},{"title":"Credits \u0026 Billing","href":"/concepts/credits"},{"title":"Webhooks","href":"/concepts/webhooks"}]},{"group":"Guides","pages":[{"title":"CRM Integration","href":"/guides/crm-integration"},{"title":"Capturing Leads via API","href":"/guides/lead-capture"},{"title":"Retry Logic","href":"/guides/retry-logic"},{"title":"Webhook Filtering","href":"/guides/webhook-filtering"},{"title":"BYON Setup Guide","href":"/guides/byon-setup"}]},{"group":"Connectors","pages":[{"title":"Connectors Overview","href":"/connectors/overview"},{"title":"Panzo CRM","href":"/connectors/panzo"},{"title":"Yellow.ai","href":"/connectors/yellowai"}]}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/overview"}]}]},"basePath":"","title":"Authentication - Oktivo Voice Platform","deploymentId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","buildId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","dynamics":[],"chunks":[]}