Creates a named API token for the current user and returns the plaintext access token and refresh token exactly once. Neither can be recovered from the server afterward, so the caller must persist both values before navigating away. The refresh token can be used against POST /api/v2/account/token to obtain a fresh access token without re-creating from the UI.
A bearer authorization header containing a Risk Cloud API access token in the format Authorization: Bearer TOKEN — replace TOKEN with your actual access token.
The persisted token row's metadata. Mirrors a single row from GET /api/v1/account/tokens so a client can populate the Access Keys table without a follow-up request after creation.
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Risk Cloud Developer Portal","description":"Build integrations with the Risk Cloud API.","colors":{"primary":"#0027D6","light":"#00E0DF","dark":"#08075F"},"logo":{"light":"https://mintcdn.com/logicgate/wf5bUfXRxvyA8aj2/logo/light.svg?fit=max\u0026auto=format\u0026n=wf5bUfXRxvyA8aj2\u0026q=85\u0026s=0caca379183dee1a2b9548fcf66c0b17","dark":"https://mintcdn.com/logicgate/wf5bUfXRxvyA8aj2/logo/dark.svg?fit=max\u0026auto=format\u0026n=wf5bUfXRxvyA8aj2\u0026q=85\u0026s=e9fb0bc3f08ab4368629e5032ab92355"},"favicon":"https://mintcdn.com/logicgate/bfWFby5E1SctnyRi/favicon.svg?fit=max\u0026auto=format\u0026n=bfWFby5E1SctnyRi\u0026q=85\u0026s=8587b8c25d8423a90a1a556eaf92d60d","api":{"openapi":["openapi.json","openapi-fixed.json"],"playground":{"proxy":false}},"navbar":{"links":[{"href":"mailto:hi@mintlify.com","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.mintlify.com"}},"footer":{"socials":{"x":"https://x.com/mintlify","github":"https://github.com/mintlify","linkedin":"https://linkedin.com/company/mintlify"}},"fonts":{"heading":{"family":"Archivo"},"body":{"family":"Inter"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"logicgate","hasAudioNarration":false,"actualSubdomain":"logicgate","customDomains":["developers.logicgate.ai"],"gitSource":{"type":"github","owner":"logicgatetech","repo":"developer-portal","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":"","_id":"6ae1107c04af33dc00e2279c"},"chroma":{"latestBuiltDeploymentHistoryId":"6ae0d64521f7c543a78f0d53","collectionId":"e4db1304-a959-4491-80a8-77d44dda0931","liveDeploymentHistoryId":"6ae0d64521f7c543a78f0d53","schemaVersion":"v3"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae1108b7d7869feb3418f99","clientVersion":"0.0.4039","searchFilterCounts":[{"language":"default","tag":"Guides","count":46},{"language":"default","tag":"API v2","count":42},{"language":"default","tag":"API Usage Guides","count":41},{"language":"default","tag":"API v1","count":36},{"language":"default","tag":"SCIM","count":15},{"language":"default","tag":"Authentication","count":9},{"language":"default","tag":"Step","count":6},{"language":"default","tag":"External User","count":6},{"language":"default","tag":"Application","count":5},{"language":"default","tag":"Edge Path","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"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":"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}],"googleFontsInlined":true},"customCss":[],"page":{"pagePath":"api-v1/authentication/create-a-new-user-managed-api-token","slug":"/api-v1/authentication/create-a-new-user-managed-api-token","pageMetadata":{"title":"Create a new user-managed API token","openapi":"POST /api/v1/account/tokens","description":"Creates a named API token for the current user and returns the plaintext access token and refresh token exactly once. Neither can be recovered from the server afterward, so the caller must persist both values before navigating away. The refresh token can be used against POST /api/v2/account/token to obtain a fresh access token without re-creating from the UI.","href":"/api-v1/authentication/create-a-new-user-managed-api-token"},"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: \"Creates a named API token for the current user and returns the plaintext access token and refresh token exactly once. Neither can be recovered from the server afterward, so the caller must persist both values before navigating away. The refresh token can be used against POST /api/v2/account/token to obtain a fresh access token without re-creating from the UI.\"\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}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create a new user-managed API token","openapi":"POST /api/v1/account/tokens","description":"Creates a named API token for the current user and returns the plaintext access token and refresh token exactly once. Neither can be recovered from the server afterward, so the caller must persist both values before navigating away. The refresh token can be used against POST /api/v2/account/token to obtain a fresh access token without re-creating from the UI.","href":"/api-v1/authentication/create-a-new-user-managed-api-token"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Authentication"],"summary":"Create a new user-managed API token","description":"Creates a named API token for the current user and returns the plaintext access token and refresh token exactly once. Neither can be recovered from the server afterward, so the caller must persist both values before navigating away. The refresh token can be used against POST /api/v2/account/token to obtain a fresh access token without re-creating from the UI.","operationId":"createToken","parameters":["af6b9805-2fe7-437d-baf3-6d201c019468"],"requestBody":"bf44b7a4-5681-4a1a-aa92-aa4bc0ebbe5d","responses":{"200":"cfc0059e-47f0-4f3e-b941-d3963be00e2c"},"method":"post","type":"path","servers":["8cbd3750-8cc4-488b-9e18-ab4328073bf6"],"security":["e853ca8d-6c46-4252-a492-8d39a67ffba6","5b427e9f-20a6-404a-bf90-340887d4163d"],"path":"/api/v1/account/tokens","baseUrlOptions":["https://{subdomain}.logicgate.com"],"title":"Create a new user-managed API token","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","disableProxy":true},"dependencies":{"parameters":{"af6b9805-2fe7-437d-baf3-6d201c019468":{"name":"Authorization","in":"header","description":"A bearer authorization header containing a Risk Cloud API access token in the format `Authorization: Bearer TOKEN` — replace `TOKEN` with your actual access token.\n\nTo obtain a Risk Cloud API access token, refer to [Obtain an API Access Token](https://www.logicgate.com/developer/risk-cloud-api-authentication/) in the [LogicGate Help Center](https://help.logicgate.com/hc/en-us).","required":true,"schema":{"type":"string","isRequired":true,"description":"A bearer authorization header containing a Risk Cloud API access token in the format `Authorization: Bearer TOKEN` — replace `TOKEN` with your actual access token.\n\nTo obtain a Risk Cloud API access token, refer to [Obtain an API Access Token](https://www.logicgate.com/developer/risk-cloud-api-authentication/) in the [LogicGate Help Center](https://help.logicgate.com/hc/en-us).","uniqueKey":"","typeLabel":"string"},"example":"Bearer TOKEN"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","description":"Request body for creating a new user-managed API token.","properties":{"name":{"type":"string","description":"Human-readable label for the token (e.g. \"My Zapier integration\").","maxLength":100,"minLength":0,"isRequired":true,"uniqueKey":"name","typeLabel":"string"}},"required":["name"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"name":"\u003cstring>"}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"cfc0059e-47f0-4f3e-b941-d3963be00e2c":{"description":"OK","content":{"application/json":{"schema":{"type":"object","description":"Newly created token including the one-time plaintext access and refresh secrets. Neither plaintext can be retrieved later.","properties":{"accessToken":{"type":"string","description":"The access token to use as a Bearer credential. Shown once.","uniqueKey":"accessToken","typeLabel":"string"},"refreshToken":{"type":"string","description":"The refresh token to use against POST /api/v2/account/token to create a fresh access token without UI re-creation. Shown once.","uniqueKey":"refreshToken","typeLabel":"string"},"token":{"type":"object","description":"The persisted token row's metadata. Mirrors a single row from GET /api/v1/account/tokens so a client can populate the Access Keys table without a follow-up request after creation.","properties":{"id":{"type":"string","description":"Token id","uniqueKey":"token.id","typeLabel":"string"},"name":{"type":"string","description":"Human-readable label set at creation","uniqueKey":"token.name","typeLabel":"string"},"created":{"type":"string","format":"date-time","description":"Timestamp the token was minted","uniqueKey":"token.created","typeLabel":"string\u003cdate-time>"},"expiresAt":{"type":"string","format":"date-time","description":"Timestamp the token expires","uniqueKey":"token.expiresAt","typeLabel":"string\u003cdate-time>"},"lastUsedAt":{"type":"string","format":"date-time","description":"Timestamp of the last successful authentication using this token; null if never used","uniqueKey":"token.lastUsedAt","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"token","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"accessToken":"\u003cstring>","refreshToken":"\u003cstring>","token":{"id":"\u003cstring>","name":"\u003cstring>","created":"2023-11-07T05:31:56Z","expiresAt":"2023-11-07T05:31:56Z","lastUsedAt":"2023-11-07T05:31:56Z"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"e853ca8d-6c46-4252-a492-8d39a67ffba6":{"ApiToken":{"type":"http","scheme":"bearer","bearerFormat":"API Token","description":"Bearer token issued via the Authentication endpoints.","scopes":[]}},"5b427e9f-20a6-404a-bf90-340887d4163d":{"basic":{"type":"http","scheme":"basic","description":"HTTP Basic auth using base64-encoded Client Key:Secret Key credentials, used only to obtain or refresh a bearer token via the Authentication endpoints.","scopes":[]}}},"servers":{"8cbd3750-8cc4-488b-9e18-ab4328073bf6":{"url":"https://{subdomain}.logicgate.com","description":"Your Risk Cloud environment.","variables":{"subdomain":{"default":"your-instance","description":"Your Risk Cloud environment's subdomain (e.g. `qa`)."}}}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"API Token","description":"Bearer token issued via the Authentication endpoints.","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer token issued via the Authentication endpoints.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"ApiToken","name":"Authorization"}],"title":"ApiToken"},{"schemes":[{"scheme":{"type":"http","scheme":"basic","description":"HTTP Basic auth using base64-encoded Client Key:Secret Key credentials, used only to obtain or refresh a bearer token via the Authentication endpoints.","scopes":[]},"schema":{"title":"Basic Auth","type":"object","description":"HTTP Basic auth using base64-encoded Client Key:Secret Key credentials, used only to obtain or refresh a bearer token via the Authentication endpoints.","isRequired":true,"properties":{"username":{"type":"string","uniqueKey":"username","isRequired":true,"typeLabel":"string","deprecated":false},"password":{"type":"string","uniqueKey":"password","isRequired":true,"typeLabel":"string","deprecated":false}},"additionalProperties":false,"deprecated":false},"schemeName":"basic","name":"Authorization"}],"title":"basic"}]},"originalFileLocation":"openapi-v1.json"},"subdomain":"logicgate","siteName":"Risk Cloud Developer Portal","title":"Create a new user-managed API token - Risk Cloud Developer Portal","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-27T16:50:20.767Z","originalFileLocation":"api-v1/authentication/create-a-new-user-managed-api-token.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=\"Creates a named API token for the current user and returns the plaintext access token and refresh token exactly once. Neither can be recovered from the server afterward, so the caller must persist both values before navigating away. The refresh token can be used against POST /api/v2/account/token to obtain a fresh access token without re-creating from the UI.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Risk Cloud Developer Portal\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/logicgate/KdQ3NCzpZHZwsLIt/_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/logicgate/KdQ3NCzpZHZwsLIt/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/logicgate/KdQ3NCzpZHZwsLIt/_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/logicgate/KdQ3NCzpZHZwsLIt/_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/logicgate/KdQ3NCzpZHZwsLIt/_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/logicgate/KdQ3NCzpZHZwsLIt/_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/logicgate/KdQ3NCzpZHZwsLIt/_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/logicgate/KdQ3NCzpZHZwsLIt/_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/logicgate/KdQ3NCzpZHZwsLIt/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create a new user-managed API token - Risk Cloud Developer Portal\">\u003cmeta data-mint-head property=\"og:description\" content=\"Creates a named API token for the current user and returns the plaintext access token and refresh token exactly once. Neither can be recovered from the server afterward, so the caller must persist both values before navigating away. The refresh token can be used against POST /api/v2/account/token to obtain a fresh access token without re-creating from the UI.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Risk Cloud Developer Portal\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developers.logicgate.ai/api-v1/authentication/create-a-new-user-managed-api-token\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://logicgate.mintlify.app/_mintlify/api/og/v2?division=Authentication\u0026amp;title=Create+a+new+user-managed+API+token\u0026amp;description=Creates+a+named+API+token+for+the+current+user+and+returns+the+plaintext+access+token+and+refresh+token+exactly+once.+Neither+can+be+recovered+from+the+server+a\u0026amp;theme=3db6b0bad7d44e8d7f790f89\u0026amp;signature=8ce023a10b6b84dd0ace7814a890a0e4d8148c26604fd39215bd6e74b69e1425\">\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=\"Create a new user-managed API token - Risk Cloud Developer Portal\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Creates a named API token for the current user and returns the plaintext access token and refresh token exactly once. Neither can be recovered from the server afterward, so the caller must persist both values before navigating away. The refresh token can be used against POST /api/v2/account/token to obtain a fresh access token without re-creating from the UI.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://logicgate.mintlify.app/_mintlify/api/og/v2?division=Authentication\u0026amp;title=Create+a+new+user-managed+API+token\u0026amp;description=Creates+a+named+API+token+for+the+current+user+and+returns+the+plaintext+access+token+and+refresh+token+exactly+once.+Neither+can+be+recovered+from+the+server+a\u0026amp;theme=3db6b0bad7d44e8d7f790f89\u0026amp;signature=8ce023a10b6b84dd0ace7814a890a0e4d8148c26604fd39215bd6e74b69e1425\">\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/logicgate/KdQ3NCzpZHZwsLIt/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Risk Cloud Developer Portal\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0027D6\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developers.logicgate.ai/api-v1/authentication/create-a-new-user-managed-api-token\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-v1/authentication/create-a-new-user-managed-api-token.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developers.logicgate.ai/#organization\",\"name\":\"Risk Cloud Developer Portal\",\"url\":\"https://developers.logicgate.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/logicgate/wf5bUfXRxvyA8aj2/logo/light.svg?fit=max\u0026auto=format\u0026n=wf5bUfXRxvyA8aj2\u0026q=85\u0026s=0caca379183dee1a2b9548fcf66c0b17\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developers.logicgate.ai#website\",\"name\":\"Risk Cloud Developer Portal\",\"url\":\"https://developers.logicgate.ai\",\"publisher\":{\"@id\":\"https://developers.logicgate.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developers.logicgate.ai/api-v1/authentication/create-a-new-user-managed-api-token#webpage\",\"url\":\"https://developers.logicgate.ai/api-v1/authentication/create-a-new-user-managed-api-token\",\"name\":\"Create a new user-managed API token\",\"description\":\"Creates a named API token for the current user and returns the plaintext access token and refresh token exactly once. Neither can be recovered from the server afterward, so the caller must persist both values before navigating away. The refresh token can be used against POST /api/v2/account/token to obtain a fresh access token without re-creating from the UI.\",\"dateModified\":\"2026-10-27T16:50:20.767Z\",\"isPartOf\":{\"@id\":\"https://developers.logicgate.ai#website\"},\"breadcrumb\":{\"@id\":\"https://developers.logicgate.ai/api-v1/authentication/create-a-new-user-managed-api-token#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developers.logicgate.ai/api-v1/authentication/create-a-new-user-managed-api-token#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Authentication\",\"item\":\"https://developers.logicgate.ai/api-v1/authentication/refresh-an-api-token\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create a new user-managed API token\",\"item\":\"https://developers.logicgate.ai/api-v1/authentication/create-a-new-user-managed-api-token\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developers.logicgate.ai/api-v1/authentication/create-a-new-user-managed-api-token#apireference\",\"headline\":\"Create a new user-managed API token\",\"name\":\"Create a new user-managed API token\",\"description\":\"Creates a named API token for the current user and returns the plaintext access token and refresh token exactly once. Neither can be recovered from the server afterward, so the caller must persist both values before navigating away. The refresh token can be used against POST /api/v2/account/token to obtain a fresh access token without re-creating from the UI.\",\"url\":\"https://developers.logicgate.ai/api-v1/authentication/create-a-new-user-managed-api-token\",\"mainEntityOfPage\":{\"@id\":\"https://developers.logicgate.ai/api-v1/authentication/create-a-new-user-managed-api-token#webpage\"},\"dateModified\":\"2026-10-27T16:50:20.767Z\",\"publisher\":{\"@id\":\"https://developers.logicgate.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://developers.logicgate.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Risk Cloud Developer Portal\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Risk Cloud Developer Portal","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API v2","pages":[{"title":"API v2","href":"/api-reference"}]},{"tab":"API v1","pages":[{"title":"API v1","sidebarTitle":"Overview","href":"/api-v1"},{"group":"Account","pages":[{"title":"Retrieve account overview details","openapi":"GET /api/v1/internal/account/details","href":"/api-v1/account/retrieve-account-overview-details"},{"title":"Retrieve account details","openapi":"GET /api/v1/account","href":"/api-v1/account/retrieve-account-details"},{"title":"Retrieve session information","openapi":"GET /api/v1/account/session","href":"/api-v1/account/retrieve-session-information"},{"title":"Retrieve public account details","openapi":"GET /api/v1/account/public","href":"/api-v1/account/retrieve-public-account-details"}]},{"group":"Authentication","pages":[{"title":"Refresh an API token","openapi":"POST /api/v2/account/token","href":"/api-v1/authentication/refresh-an-api-token"},{"title":"List the current user's API tokens","openapi":"GET /api/v1/account/tokens","description":"Returns a paginated list of the current user's user-managed API tokens. Excludes system-issued tokens which are not directly managed by the user. Sorted by creation time descending by default.","href":"/api-v1/authentication/list-the-current-user-s-api-tokens"},{"title":"Create a new user-managed API token","openapi":"POST /api/v1/account/tokens","href":"/api-v1/authentication/create-a-new-user-managed-api-token"},{"title":"Create an API Access Token","openapi":"POST /api/v1/account/token","description":"**Permissions:** Authenticated User\n\nGenerates a new, expiring access token from the provided Client and Secret keys.","href":"/api-v1/authentication/create-an-api-access-token"},{"title":"Retrieve an external access token","openapi":"GET /api/v1/account/external/token","href":"/api-v1/authentication/retrieve-an-external-access-token"},{"title":"Revoke an external access token","openapi":"DELETE /api/v1/account/external/token","href":"/api-v1/authentication/revoke-an-external-access-token"},{"title":"Revoke a user-managed API token","openapi":"DELETE /api/v1/account/tokens/{id}","href":"/api-v1/authentication/revoke-a-user-managed-api-token"}]},{"group":"External User","pages":[{"title":"Create an external user with no attached roles.","openapi":"POST /api/v1/users/external","href":"/api-v1/external-user/create-an-external-user-with-no-attached-roles"},{"title":"Verify MFA for external user","openapi":"POST /api/v1/users/external/verify-mfa","href":"/api-v1/external-user/verify-mfa-for-external-user"},{"title":"Send an email containing an MFA code to the specified email.","openapi":"POST /api/v1/users/external/email","href":"/api-v1/external-user/send-an-email-containing-an-mfa-code-to-the-specified-email"},{"title":"Bulk-create external users with no attached roles.","openapi":"POST /api/v1/users/external/bulk-create","href":"/api-v1/external-user/bulk-create-external-users-with-no-attached-roles"},{"title":"Return all record tokens authorizing the given user.","openapi":"GET /api/v1/users/external/{userId}/record-tokens","href":"/api-v1/external-user/return-all-record-tokens-authorizing-the-given-user"},{"title":"Retrieve an external token based off the associated record entity.","openapi":"GET /api/v1/users/external/tokens/{recordId}","href":"/api-v1/external-user/retrieve-an-external-token-based-off-the-associated-record-entity"}]},{"group":"Principal","pages":[{"title":"Get the authenticated principal.","openapi":"GET /api/v1/principal","href":"/api-v1/principal/get-the-authenticated-principal"}]},{"group":"SCIM","pages":[{"title":"Retrieve a SCIM user","openapi":"GET /scim/v2/Users/{userId}","href":"/api-v1/scim/retrieve-a-scim-user"},{"title":"Replace a SCIM user","openapi":"PUT /scim/v2/Users/{userId}","href":"/api-v1/scim/replace-a-scim-user"},{"title":"Deactivate a SCIM user","openapi":"DELETE /scim/v2/Users/{userId}","href":"/api-v1/scim/deactivate-a-scim-user"},{"title":"Update a SCIM user","openapi":"PATCH /scim/v2/Users/{userId}","href":"/api-v1/scim/update-a-scim-user"},{"title":"Retrieve a SCIM group","openapi":"GET /scim/v2/Groups/{groupId}","href":"/api-v1/scim/retrieve-a-scim-group"},{"title":"Replace a SCIM group","openapi":"PUT /scim/v2/Groups/{groupId}","href":"/api-v1/scim/replace-a-scim-group"},{"title":"Delete a SCIM group","openapi":"DELETE /scim/v2/Groups/{groupId}","href":"/api-v1/scim/delete-a-scim-group"},{"title":"Update a SCIM group","openapi":"PATCH /scim/v2/Groups/{groupId}","href":"/api-v1/scim/update-a-scim-group"},{"title":"List SCIM users","openapi":"GET /scim/v2/Users","href":"/api-v1/scim/list-scim-users"},{"title":"Create a SCIM user","openapi":"POST /scim/v2/Users","href":"/api-v1/scim/create-a-scim-user"},{"title":"List SCIM groups","openapi":"GET /scim/v2/Groups","href":"/api-v1/scim/list-scim-groups"},{"title":"Create a SCIM group","openapi":"POST /scim/v2/Groups","href":"/api-v1/scim/create-a-scim-group"},{"title":"Retrieve SCIM service provider configuration","openapi":"GET /scim/v2/ServiceProviderConfig","href":"/api-v1/scim/retrieve-scim-service-provider-configuration"},{"title":"Retrieve SCIM schemas","openapi":"GET /scim/v2/Schemas","href":"/api-v1/scim/retrieve-scim-schemas"},{"title":"Retrieve SCIM resource types","openapi":"GET /scim/v2/ResourceTypes","href":"/api-v1/scim/retrieve-scim-resource-types"}]}],"groups":[{"group":"SCIM","pages":[{"title":"Retrieve a SCIM user","deprecated":null,"version":null,"openapi":"/openapi-v1.json get /scim/v2/Users/{userId}","href":"/api-reference/scim/retrieve-a-scim-user"},{"title":"Replace a SCIM user","deprecated":null,"version":null,"openapi":"/openapi-v1.json put /scim/v2/Users/{userId}","href":"/api-reference/scim/replace-a-scim-user"},{"title":"Deactivate a SCIM user","deprecated":null,"version":null,"openapi":"/openapi-v1.json delete /scim/v2/Users/{userId}","href":"/api-reference/scim/deactivate-a-scim-user"},{"title":"Update a SCIM user","deprecated":null,"version":null,"openapi":"/openapi-v1.json patch /scim/v2/Users/{userId}","href":"/api-reference/scim/update-a-scim-user"},{"title":"Retrieve a SCIM group","deprecated":null,"version":null,"openapi":"/openapi-v1.json get /scim/v2/Groups/{groupId}","href":"/api-reference/scim/retrieve-a-scim-group"},{"title":"Replace a SCIM group","deprecated":null,"version":null,"openapi":"/openapi-v1.json put /scim/v2/Groups/{groupId}","href":"/api-reference/scim/replace-a-scim-group"},{"title":"Delete a SCIM group","deprecated":null,"version":null,"openapi":"/openapi-v1.json delete /scim/v2/Groups/{groupId}","href":"/api-reference/scim/delete-a-scim-group"},{"title":"Update a SCIM group","deprecated":null,"version":null,"openapi":"/openapi-v1.json patch /scim/v2/Groups/{groupId}","href":"/api-reference/scim/update-a-scim-group"},{"title":"List SCIM users","deprecated":null,"version":null,"openapi":"/openapi-v1.json get /scim/v2/Users","href":"/api-reference/scim/list-scim-users"},{"title":"Create a SCIM user","deprecated":null,"version":null,"openapi":"/openapi-v1.json post /scim/v2/Users","href":"/api-reference/scim/create-a-scim-user"},{"title":"List SCIM groups","deprecated":null,"version":null,"openapi":"/openapi-v1.json get /scim/v2/Groups","href":"/api-reference/scim/list-scim-groups"},{"title":"Create a SCIM group","deprecated":null,"version":null,"openapi":"/openapi-v1.json post /scim/v2/Groups","href":"/api-reference/scim/create-a-scim-group"},{"title":"Retrieve SCIM service provider configuration","deprecated":null,"version":null,"openapi":"/openapi-v1.json get /scim/v2/ServiceProviderConfig","href":"/api-reference/scim/retrieve-scim-service-provider-configuration"},{"title":"Retrieve SCIM schemas","deprecated":null,"version":null,"openapi":"/openapi-v1.json get /scim/v2/Schemas","href":"/api-reference/scim/retrieve-scim-schemas"},{"title":"Retrieve SCIM resource types","deprecated":null,"version":null,"openapi":"/openapi-v1.json get /scim/v2/ResourceTypes","href":"/api-reference/scim/retrieve-scim-resource-types"}]},{"group":"Authentication","pages":[{"title":"Refresh an API token","openapi":"POST /api/v2/account/token","href":"/api-reference/authentication/refresh-an-api-token"},{"title":"List the current user's API tokens","deprecated":null,"version":null,"openapi":"/openapi-v1.json get /api/v1/account/tokens","href":"/api-reference/authentication/list-the-current-users-api-tokens"},{"title":"Create a new user-managed API token","deprecated":null,"version":null,"openapi":"/openapi-v1.json post /api/v1/account/tokens","href":"/api-reference/authentication/create-a-new-user-managed-api-token"},{"title":"Create an API Access Token","openapi":"POST /api/v1/account/token","href":"/api-reference/authentication/create-an-api-access-token"},{"title":"Retrieve an external access token","deprecated":null,"version":null,"openapi":"/openapi-v1.json get /api/v1/account/external/token","href":"/api-reference/authentication/retrieve-an-external-access-token"},{"title":"Revoke an external access token","deprecated":null,"version":null,"openapi":"/openapi-v1.json delete /api/v1/account/external/token","href":"/api-reference/authentication/revoke-an-external-access-token"},{"title":"Revoke a user-managed API token","deprecated":null,"version":null,"openapi":"/openapi-v1.json delete /api/v1/account/tokens/{id}","href":"/api-reference/authentication/revoke-a-user-managed-api-token"}]},{"group":"External User","pages":[{"title":"Create an external user with no attached roles.","deprecated":null,"version":null,"openapi":"/openapi-v1.json post /api/v1/users/external","href":"/api-reference/external-user/create-an-external-user-with-no-attached-roles"},{"title":"Verify MFA for external user","deprecated":null,"version":null,"openapi":"/openapi-v1.json post /api/v1/users/external/verify-mfa","href":"/api-reference/external-user/verify-mfa-for-external-user"},{"title":"Send an email containing an MFA code to the specified email.","deprecated":null,"version":null,"openapi":"/openapi-v1.json post /api/v1/users/external/email","href":"/api-reference/external-user/send-an-email-containing-an-mfa-code-to-the-specified-email"},{"title":"Bulk-create external users with no attached roles.","deprecated":null,"version":null,"openapi":"/openapi-v1.json post /api/v1/users/external/bulk-create","href":"/api-reference/external-user/bulk-create-external-users-with-no-attached-roles"},{"title":"Return all record tokens authorizing the given user.","deprecated":null,"version":null,"openapi":"/openapi-v1.json get /api/v1/users/external/{userId}/record-tokens","href":"/api-reference/external-user/return-all-record-tokens-authorizing-the-given-user"},{"title":"Retrieve an external token based off the associated record entity.","deprecated":null,"version":null,"openapi":"/openapi-v1.json get /api/v1/users/external/tokens/{recordId}","href":"/api-reference/external-user/retrieve-an-external-token-based-off-the-associated-record-entity"}]},{"group":"Principal","pages":[{"title":"Get the authenticated principal.","deprecated":null,"version":null,"openapi":"/openapi-v1.json get /api/v1/principal","href":"/api-reference/principal/get-the-authenticated-principal"}]},{"group":"Account","pages":[{"title":"Retrieve account overview details","deprecated":null,"version":null,"openapi":"/openapi-v1.json get /api/v1/internal/account/details","href":"/api-reference/account/retrieve-account-overview-details"},{"title":"Retrieve account details","deprecated":null,"version":null,"openapi":"/openapi-v1.json get /api/v1/account","href":"/api-reference/account/retrieve-account-details"},{"title":"Retrieve session information","deprecated":null,"version":null,"openapi":"/openapi-v1.json get /api/v1/account/session","href":"/api-reference/account/retrieve-session-information"},{"title":"Retrieve public account details","deprecated":null,"version":null,"openapi":"/openapi-v1.json get /api/v1/account/public","href":"/api-reference/account/retrieve-public-account-details"}]}]},{"tab":"Release Notes","pages":[{"title":"Release Notes","href":"/release-notes"}]},{"tab":"Developer Blog","pages":[{"title":"Developer Blog","href":"/blog-archive"}]}]},"basePath":"","title":"Create a new user-managed API token - Risk Cloud Developer Portal","buildId":"dpl_77Hw7ZuAABM8E3WMbYAf2ohQCr3v","deploymentId":"dpl_77Hw7ZuAABM8E3WMbYAf2ohQCr3v","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CVpqyvFO.js","utils-vpweLD0v.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BIOodqb0.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B1LM3qmu.js","snippetPresets-C5xK0GtN.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CCsxLnQl.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C2-WKG22.js","shallow-SdoLUC-q.js","getApiPlaygroundDisplay-BnI8L2hB.js","CodeSnippet-D5M8NCHI.js","CodeSnippets-CXRO8Uom.js","Page-CN9QbZiA.js","getPastedJson-CrfHEdRt.js","icon-Cr8AyUnW.js","MethodPill-J_Cs0kNw.js","DuplicateIcon-DrMboxGw.js","createIcon-B4CIWVbU.js","DynamicMarkdown-D9cdbgj9.js","SectionHeading-BO4CouT0.js","axios-vUo_bRtp.js","Markdown-L1m1-PSi.js","clsx-rIpTdK8h.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-ptfS1uB_.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-D31Sm3f9.js"]}