{
"error": "Missing or invalid authorization header"
}
{
"error": "Permission denied"
}
{
"error": "A policy with this name already exists"
}
Users
Create user
Creates an active company user and sends a welcome sign-in email. Requires auth.add_user and an available user seat. Optionally supply either role_id or role_name, never both. Role assignment requires a plan supporting roles; Admin cannot be assigned, and the caller must hold every permission in the selected role. Duplicate email or user limits return 409.
{"docsConfig":{"theme":"palm","$schema":"https://mintlify.com/docs.json","name":"Corgea Documentation","colors":{"primary":"#F56C26","light":"#F56C26","dark":"#F56C26"},"logo":{"light":"https://mintcdn.com/corgea/mpJUc1GyXtnVYEyT/logo/logo.png?fit=max\u0026auto=format\u0026n=mpJUc1GyXtnVYEyT\u0026q=85\u0026s=f66a9484335ac4db5d5d92e12fd87af6","dark":"https://mintcdn.com/corgea/mpJUc1GyXtnVYEyT/logo/logo.png?fit=max\u0026auto=format\u0026n=mpJUc1GyXtnVYEyT\u0026q=85\u0026s=f66a9484335ac4db5d5d92e12fd87af6"},"favicon":"https://mintcdn.com/corgea/mpJUc1GyXtnVYEyT/logo/logo.png?fit=max\u0026auto=format\u0026n=mpJUc1GyXtnVYEyT\u0026q=85\u0026s=f66a9484335ac4db5d5d92e12fd87af6","background":{"color":{"light":"#fffdfd","dark":"#131313"}},"navbar":{"links":[{"href":"mailto:help@corgea.com","label":"Support"}],"primary":{"type":"button","label":"Go to Corgea","href":"https://www.corgea.app"}},"footer":{"socials":{"twitter":"https://x.com/CorgeaInc","github":"https://github.com/Corgea","linkedin":"https://www.linkedin.com/company/corgea"}},"integrations":{"ga4":{"measurementId":"G-GGF9NXG1LJ"}},"styling":{"latex":false},"navigation":{"languages":[{"language":"en","default":true,"navbar":{"links":[{"href":"mailto:help@corgea.com","label":"Support"}],"primary":{"type":"button","label":"Go to Corgea","href":"https://www.corgea.app"}},"href":"introduction"},{"language":"de","navbar":{"links":[{"href":"mailto:help@corgea.com","label":"Support"}],"primary":{"type":"button","label":"Zu Corgea","href":"https://www.corgea.app"}},"href":"de/introduction"},{"language":"fr","navbar":{"links":[{"href":"mailto:help@corgea.com","label":"Assistance"}],"primary":{"type":"button","label":"Accéder à Corgea","href":"https://www.corgea.app"}},"href":"fr/introduction"},{"language":"es","navbar":{"links":[{"href":"mailto:help@corgea.com","label":"Soporte"}],"primary":{"type":"button","label":"Ir a Corgea","href":"https://www.corgea.app"}},"href":"es/introduction"},{"language":"ja","navbar":{"links":[{"href":"mailto:help@corgea.com","label":"サポート"}],"primary":{"type":"button","label":"Corgeaを開く","href":"https://www.corgea.app"}},"href":"ja/introduction"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"corgea","hasAudioNarration":false,"actualSubdomain":"corgea","customDomains":["docs.corgea.app"],"gitSource":{"type":"github","owner":"corgea","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae550291d528968cec4ede6","collectionId":"fa225268-b341-4285-9fb7-c791f78b926b","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae550291d528968cec4ede6"},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6ae550291d528968cec4ede6","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"en","tag":"API Reference","count":83},{"language":"de","tag":"API-Referenz","count":83},{"language":"es","tag":"Referencia de la API","count":83},{"language":"fr","tag":"Référence API","count":83},{"language":"ja","tag":"APIリファレンス","count":80},{"language":"en","tag":"Documentation","count":57},{"language":"de","tag":"Dokumentation","count":55},{"language":"es","tag":"Documentación","count":55},{"language":"fr","tag":"Documentation","count":55},{"language":"ja","tag":"ドキュメント","count":55},{"language":"en","tag":"Core Features","count":30},{"language":"de","tag":"Kernfunktionen","count":30},{"language":"es","tag":"Funciones principales","count":30},{"language":"fr","tag":"Fonctionnalités principales","count":30},{"language":"ja","tag":"主な機能","count":30},{"language":"en","tag":"Issues","count":16},{"language":"de","tag":"Issues","count":16},{"language":"es","tag":"Hallazgos","count":16},{"language":"fr","tag":"Problèmes","count":16},{"language":"ja","tag":"問題","count":16},{"language":"en","tag":"Integrations","count":15},{"language":"de","tag":"Integrationen","count":15},{"language":"es","tag":"Integraciones","count":15},{"language":"fr","tag":"Intégrations","count":15},{"language":"ja","tag":"インテグレーション","count":15},{"language":"en","tag":"Security Scanning","count":10},{"language":"de","tag":"Sicherheitsscans","count":10},{"language":"es","tag":"Análisis de seguridad","count":10},{"language":"fr","tag":"Analyse de sécurité","count":10},{"language":"ja","tag":"セキュリティスキャン","count":10},{"language":"en","tag":"Authentication","count":8},{"language":"en","tag":"Teams","count":8},{"language":"de","tag":"Authentifizierung","count":8},{"language":"de","tag":"Teams","count":8},{"language":"es","tag":"Autenticación","count":8},{"language":"es","tag":"Equipos","count":8},{"language":"fr","tag":"Authentification","count":8},{"language":"fr","tag":"Équipes","count":8},{"language":"ja","tag":"認証","count":8},{"language":"ja","tag":"チーム","count":8},{"language":"en","tag":"Issue Management","count":7},{"language":"en","tag":"Notifications","count":7},{"language":"de","tag":"Issue-Management","count":7},{"language":"de","tag":"Benachrichtigungen","count":7},{"language":"es","tag":"Gestión de hallazgos","count":7},{"language":"es","tag":"Notificaciones","count":7},{"language":"fr","tag":"Gestion des résultats","count":7},{"language":"fr","tag":"Notifications","count":7},{"language":"ja","tag":"検出結果の管理","count":7},{"language":"ja","tag":"通知","count":7}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/users/create-user","slug":"/api-reference/users/create-user","pageMetadata":{"title":"Create user","description":"Creates an active company user and sends a welcome sign-in email. Requires `auth.add_user` and an available user seat. Optionally supply either role_id or role_name, never both. Role assignment requires a plan supporting roles; Admin cannot be assigned, and the caller must hold every permission in the selected role. Duplicate email or user limits return 409.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /users","href":"/api-reference/users/create-user","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Creates an active company user and sends a welcome sign-in email. Requires \", _jsx(_components.code, {\n children: \"auth.add_user\"\n }), \" and an available user seat. Optionally supply either role_id or role_name, never both. Role assignment requires a plan supporting roles; Admin cannot be assigned, and the caller must hold every permission in the selected role. Duplicate email or user limits return 409.\"]\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 user","description":"Creates an active company user and sends a welcome sign-in email. Requires `auth.add_user` and an available user seat. Optionally supply either role_id or role_name, never both. Role assignment requires a plan supporting roles; Admin cannot be assigned, and the caller must hold every permission in the selected role. Duplicate email or user limits return 409.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /users","href":"/api-reference/users/create-user","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Create user","operationId":"createUser","tags":["Users"],"description":"Creates an active company user and sends a welcome sign-in email. Requires `auth.add_user` and an available user seat. Optionally supply either role_id or role_name, never both. Role assignment requires a plan supporting roles; Admin cannot be assigned, and the caller must hold every permission in the selected role. Duplicate email or user limits return 409.","responses":{"201":"f7635942-0e98-4426-8ff7-8a6ec5b32479","400":"0699ea7e-32f9-4a71-826b-ac51de10cdd0","401":"000766b8-b985-4806-a569-11f447a45d62","403":"d496848d-e3cf-4c42-b908-f8a6a0d786ac","409":"b2096ca3-80de-47a1-b166-6782d5279dc3"},"requestBody":"75e5acc5-f92d-42ad-964e-d0fc426ed59f","method":"post","type":"path","servers":["a3a09265-ee08-4004-99c9-c7b5341af7e9","ffb311c1-c94b-4382-8cbd-b110b9022523"],"security":["4785be93-10b9-4ada-8ad2-6eb14e6619f6","156ec6b3-c21b-44f9-9615-f48ba84a3585"],"path":"/users","baseUrlOptions":["https://www.corgea.app/api/v1","https://eu.corgea.app/api/v1"],"title":"Create user","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","format":"email","isRequired":true,"uniqueKey":"email","typeLabel":"string\u003cemail>"},"first_name":{"type":"string","minLength":1,"maxLength":150,"isRequired":true,"uniqueKey":"first_name","typeLabel":"string"},"last_name":{"type":"string","minLength":1,"maxLength":150,"isRequired":true,"uniqueKey":"last_name","typeLabel":"string"},"role_id":{"type":"integer","uniqueKey":"role_id","typeLabel":"integer"},"role_name":{"type":"string","uniqueKey":"role_name","typeLabel":"string"}},"required":["email","first_name","last_name"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"email":"jsmith@example.com","first_name":"\u003cstring>","last_name":"\u003cstring>","role_id":123,"role_name":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"f7635942-0e98-4426-8ff7-8a6ec5b32479":{"description":"Request completed successfully","content":{"application/json":{"schema":{"type":"object","properties":{"user":{"type":"object","properties":{"id":{"type":"integer","uniqueKey":"user.id","typeLabel":"integer"},"email":{"type":"string","format":"email","uniqueKey":"user.email","typeLabel":"string\u003cemail>"},"first_name":{"type":"string","uniqueKey":"user.first_name","typeLabel":"string"},"last_name":{"type":"string","uniqueKey":"user.last_name","typeLabel":"string"},"active":{"type":"boolean","uniqueKey":"user.active","typeLabel":"boolean"},"roles":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer","uniqueKey":"user.roles.items.[INDEX].id","typeLabel":"integer"},"name":{"type":"string","uniqueKey":"user.roles.items.[INDEX].name","typeLabel":"string"}},"uniqueKey":"user.roles.items.[INDEX]","typeLabel":"object"},"uniqueKey":"user.roles","typeLabel":"object[]"},"created_at":{"type":"string","format":"date-time","uniqueKey":"user.created_at","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"user","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"user":{"id":123,"email":"jsmith@example.com","first_name":"\u003cstring>","last_name":"\u003cstring>","active":true,"roles":[{"id":123,"name":"\u003cstring>"}],"created_at":"2023-11-07T05:31:56Z"}}}},"exampleType":"generated"}},"exampleType":"generated"},"0699ea7e-32f9-4a71-826b-ac51de10cdd0":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"Invalid JSON body","uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"Invalid JSON body"}}},"exampleType":"generated"}},"exampleType":"generated"},"000766b8-b985-4806-a569-11f447a45d62":{"description":"Invalid or missing token","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"Missing or invalid authorization header","uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"Missing or invalid authorization header"}}},"exampleType":"generated"}},"exampleType":"generated"},"d496848d-e3cf-4c42-b908-f8a6a0d786ac":{"description":"Permission denied or feature unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"Permission denied","uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"Permission denied"}}},"exampleType":"generated"}},"exampleType":"generated"},"b2096ca3-80de-47a1-b166-6782d5279dc3":{"description":"Request conflicts with an existing resource","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"A policy with this name already exists","uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"A policy with this name already exists"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"4785be93-10b9-4ada-8ad2-6eb14e6619f6":{"CorgeaToken":{"type":"apiKey","in":"header","name":"CORGEA-TOKEN","description":"API key for authentication API tokens belonging to inactive users are rejected.","scopes":[],"schemeName":"CorgeaToken"}},"156ec6b3-c21b-44f9-9615-f48ba84a3585":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"OAuth2 access token (JWT) in the Authorization header","scopes":[],"schemeName":"BearerAuth"}}},"servers":{"a3a09265-ee08-4004-99c9-c7b5341af7e9":{"url":"https://www.corgea.app/api/v1","description":"Production server"},"ffb311c1-c94b-4382-8cbd-b110b9022523":{"url":"https://eu.corgea.app/api/v1","description":"EU production server"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"CORGEA-TOKEN","description":"API key for authentication API tokens belonging to inactive users are rejected.","scopes":[],"schemeName":"CorgeaToken"},"schema":{"title":"CORGEA-TOKEN","type":"string","description":"API key for authentication API tokens belonging to inactive users are rejected.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"CorgeaToken","name":"CORGEA-TOKEN"}],"title":"CorgeaToken"},{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"OAuth2 access token (JWT) in the Authorization header","scopes":[],"schemeName":"BearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"OAuth2 access token (JWT) in the Authorization header","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"corgea","siteName":"Corgea Documentation","title":"Create user - Corgea Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api-reference/users/create-user","matchLevel":0},"de":{"href":"/de/introduction","matchLevel":4},"fr":{"href":"/fr/introduction","matchLevel":4},"es":{"href":"/es/introduction","matchLevel":4},"ja":{"href":"/ja/introduction","matchLevel":4}}},"lastModified":"2026-10-31T02:19:35.888Z","originalFileLocation":"api-reference/users/create-user.mdx","locale":"en"},"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 an active company user and sends a welcome sign-in email. Requires auth.add_user and an available user seat. Optionally supply either role_id or role_name, never both. Role assignment requires a plan supporting roles; Admin cannot be assigned, and the caller must hold every permission in the selected role. Duplicate email or user limits return 409.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Corgea Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/corgea/S1IZmkPVVuf-3VMn/_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/corgea/S1IZmkPVVuf-3VMn/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/corgea/S1IZmkPVVuf-3VMn/_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/corgea/S1IZmkPVVuf-3VMn/_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/corgea/S1IZmkPVVuf-3VMn/_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/corgea/S1IZmkPVVuf-3VMn/_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/corgea/S1IZmkPVVuf-3VMn/_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/corgea/S1IZmkPVVuf-3VMn/_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/corgea/S1IZmkPVVuf-3VMn/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create user - Corgea Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Creates an active company user and sends a welcome sign-in email. Requires auth.add_user and an available user seat. Optionally supply either role_id or role_name, never both. Role assignment requires a plan supporting roles; Admin cannot be assigned, and the caller must hold every permission in the selected role. Duplicate email or user limits return 409.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Corgea Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.corgea.app/api-reference/users/create-user\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://corgea.mintlify.app/_mintlify/api/og/v2?division=Users\u0026amp;title=Create+user\u0026amp;description=Creates+an+active+company+user+and+sends+a+welcome+sign-in+email.+Requires+%60auth.add_user%60+and+an+available+user+seat.+Optionally+supply+either+role_id+or+role_\u0026amp;theme=41074bc9e80898ad3ff58073\u0026amp;signature=0ce077eb3371b3805e3ca74e4d049109607f4ef1d572c465300ba6569c8218e2\">\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 user - Corgea Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Creates an active company user and sends a welcome sign-in email. Requires auth.add_user and an available user seat. Optionally supply either role_id or role_name, never both. Role assignment requires a plan supporting roles; Admin cannot be assigned, and the caller must hold every permission in the selected role. Duplicate email or user limits return 409.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://corgea.mintlify.app/_mintlify/api/og/v2?division=Users\u0026amp;title=Create+user\u0026amp;description=Creates+an+active+company+user+and+sends+a+welcome+sign-in+email.+Requires+%60auth.add_user%60+and+an+available+user+seat.+Optionally+supply+either+role_id+or+role_\u0026amp;theme=41074bc9e80898ad3ff58073\u0026amp;signature=0ce077eb3371b3805e3ca74e4d049109607f4ef1d572c465300ba6569c8218e2\">\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/corgea/S1IZmkPVVuf-3VMn/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Corgea Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#F56C26\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.corgea.app/api-reference/users/create-user\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/users/create-user.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.corgea.app/#organization\",\"name\":\"Corgea Documentation\",\"url\":\"https://docs.corgea.app\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/corgea/mpJUc1GyXtnVYEyT/logo/logo.png?fit=max\u0026auto=format\u0026n=mpJUc1GyXtnVYEyT\u0026q=85\u0026s=f66a9484335ac4db5d5d92e12fd87af6\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.corgea.app#website\",\"name\":\"Corgea Documentation\",\"url\":\"https://docs.corgea.app\",\"publisher\":{\"@id\":\"https://docs.corgea.app/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.corgea.app/api-reference/users/create-user#webpage\",\"url\":\"https://docs.corgea.app/api-reference/users/create-user\",\"name\":\"Create user\",\"description\":\"Creates an active company user and sends a welcome sign-in email. Requires auth.add_user and an available user seat. Optionally supply either role_id or role_name, never both. Role assignment requires a plan supporting roles; Admin cannot be assigned, and the caller must hold every permission in the selected role. Duplicate email or user limits return 409.\",\"dateModified\":\"2026-10-31T02:19:35.888Z\",\"isPartOf\":{\"@id\":\"https://docs.corgea.app#website\"},\"breadcrumb\":{\"@id\":\"https://docs.corgea.app/api-reference/users/create-user#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.corgea.app/api-reference/users/create-user#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Users\",\"item\":\"https://docs.corgea.app/api-reference/users/list-users\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create user\",\"item\":\"https://docs.corgea.app/api-reference/users/create-user\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.corgea.app/api-reference/users/create-user#apireference\",\"headline\":\"Create user\",\"name\":\"Create user\",\"description\":\"Creates an active company user and sends a welcome sign-in email. Requires auth.add_user and an available user seat. Optionally supply either role_id or role_name, never both. Role assignment requires a plan supporting roles; Admin cannot be assigned, and the caller must hold every permission in the selected role. Duplicate email or user limits return 409.\",\"url\":\"https://docs.corgea.app/api-reference/users/create-user\",\"mainEntityOfPage\":{\"@id\":\"https://docs.corgea.app/api-reference/users/create-user#webpage\"},\"dateModified\":\"2026-10-31T02:19:35.888Z\",\"publisher\":{\"@id\":\"https://docs.corgea.app/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.corgea.app#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Corgea Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Corgea Documentation","nav":{"global":null,"languages":[{"language":"en","default":true,"navbar":{"links":[{"href":"mailto:help@corgea.com","label":"Support"}],"primary":{"type":"button","label":"Go to Corgea","href":"https://www.corgea.app"}},"anchors":[{"anchor":"Documentation","icon":"book-open","pages":[{"title":"Documentation","href":"/introduction"}]},{"anchor":"Service Status","icon":"check","href":"https://status.corgea.app/"},{"anchor":"Blog","icon":"newspaper","href":"https://corgea.com/blog"},{"anchor":"API Reference","icon":"square-terminal","groups":[{"group":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/introduction"},{"title":"Findings and Detections","href":"/api-reference/findings-and-detections"},{"title":"Chunked scan upload","href":"/api-reference/chunked-scan-upload"}]},{"group":"Authentication","pages":[{"title":"Verify Token (Deprecated)","deprecated":true,"version":null,"openapi":"/api-reference/openapi.json get /verify/{token}","href":"/api-reference/authentication/verify-token-deprecated"},{"title":"Verify Token","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /verify","href":"/api-reference/authentication/verify-token"},{"title":"Get Login Attempts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /auth/logins","href":"/api-reference/authentication/get-login-attempts"},{"title":"Get Failed Login Attempts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /auth/failed-logins","href":"/api-reference/authentication/get-failed-login-attempts"},{"title":"Get User Login Attempts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /users/{user_id}/logins","href":"/api-reference/authentication/get-user-login-attempts"},{"title":"Get User Failed Login Attempts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /users/{user_id}/failed-logins","href":"/api-reference/authentication/get-user-failed-login-attempts"}]},{"group":"Scans","pages":[{"title":"Get Scans","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /scans","href":"/api-reference/scans/get-scans"},{"title":"Get Scan","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /scan/{scan_id}","href":"/api-reference/scans/get-scan"},{"title":"Get Scan Report","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /scan/{scan_id}/report","href":"/api-reference/scans/get-scan-report"},{"title":"Check Blocking Rules","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /scan/{scan_id}/check_blocking_rules","href":"/api-reference/scans/check-blocking-rules"}]},{"group":"Issues","pages":[{"title":"List All Issues","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /issues","href":"/api-reference/issues/list-all-issues"},{"title":"List Security Issue Groups","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /issues/groups","href":"/api-reference/issues/list-security-issue-groups"},{"title":"List Code Quality Issues","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /issues/code-quality","href":"/api-reference/issues/list-code-quality-issues"},{"title":"Get Code Quality Issues for Scan","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /scan/{scan_id}/issues/quality","href":"/api-reference/issues/get-code-quality-issues-for-scan"},{"title":"Get Issues for Scan","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /scan/{scan_id}/issues","href":"/api-reference/issues/get-issues-for-scan"},{"title":"List Security Issue Groups for a Scan","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /scan/{scan_id}/issues/groups","href":"/api-reference/issues/list-security-issue-groups-for-a-scan"},{"title":"List Code Quality Issue Groups for a Scan","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /scan/{scan_id}/issues/quality/groups","href":"/api-reference/issues/list-code-quality-issue-groups-for-a-scan"},{"title":"List SCA Issue Groups for a Scan","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /scan/{scan_id}/issues/sca/groups","href":"/api-reference/issues/list-sca-issue-groups-for-a-scan"},{"title":"Get Issue","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /issue/{issue_id}","href":"/api-reference/issues/get-issue"},{"title":"Update issue status","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /issue/{issue_id}","href":"/api-reference/issues/update-issue-status"},{"title":"Get SCA Issue","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /issues/sca/{issue_id}","href":"/api-reference/issues/get-sca-issue"},{"title":"Get SCA Issues","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /issues/sca","href":"/api-reference/issues/get-sca-issues"},{"title":"List SCA Issue Groups","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /issues/sca/groups","href":"/api-reference/issues/list-sca-issue-groups"},{"title":"Get IaC Issues","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /issues/iac","href":"/api-reference/issues/get-iac-issues"},{"title":"Get SCA Issues for Scan","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /scan/{scan_id}/issues/sca","href":"/api-reference/issues/get-sca-issues-for-scan"},{"title":"Get IaC Issues for Scan","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /scan/{scan_id}/issues/iac","href":"/api-reference/issues/get-iac-issues-for-scan"}]},{"group":"Findings","pages":[{"title":"List findings","deprecated":null,"version":null,"sidebarTitle":"List findings","openapi":"/api-reference/openapi.json get /findings","href":"/api-reference/findings/list-findings"},{"title":"Get a finding","deprecated":null,"version":null,"sidebarTitle":"Get a finding","openapi":"/api-reference/openapi.json get /findings/{finding_id}","href":"/api-reference/findings/get-a-finding"}]},{"group":"Triage","pages":[{"title":"Bulk triage findings","deprecated":null,"version":null,"sidebarTitle":"Bulk triage findings","openapi":"/api-reference/openapi.json patch /triage/findings","href":"/api-reference/triage/bulk-triage-findings"},{"title":"Get a triage action","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /triage/actions/{action_id}","href":"/api-reference/triage/get-a-triage-action"},{"title":"Review a triage action","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /triage/actions/{action_id}","href":"/api-reference/triage/review-a-triage-action"},{"title":"Get the triage approval policy","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /triage/approval-policy","href":"/api-reference/triage/get-the-triage-approval-policy"},{"title":"Update the triage approval policy","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /triage/approval-policy","href":"/api-reference/triage/update-the-triage-approval-policy"}]},{"group":"Dependencies","pages":[{"title":"Get Dependencies","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /dependencies","href":"/api-reference/dependencies/get-dependencies"},{"title":"Download Scan SBOM","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /scan/{scan_id}/sbom","href":"/api-reference/dependencies/download-scan-sbom"},{"title":"Get Dependencies for Scan","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /scan/{scan_id}/dependencies","href":"/api-reference/dependencies/get-dependencies-for-scan"}]},{"group":"Starting Corgea Scan","pages":[{"title":"Start New Scan","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /start-scan","href":"/api-reference/starting-corgea-scan/start-new-scan"},{"title":"Check Upload Status","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json head /start-scan/{transfer_id}/","href":"/api-reference/starting-corgea-scan/check-upload-status"},{"title":"Continue Scan Upload","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /start-scan/{transfer_id}/","href":"/api-reference/starting-corgea-scan/continue-scan-upload"}]},{"group":"Uploading 3rd Party Scan","pages":[{"title":"Upload Scan","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /scan-upload","href":"/api-reference/uploading-3rd-party-scan/upload-scan"},{"title":"Upload Git Config","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /git-config-upload","href":"/api-reference/uploading-3rd-party-scan/upload-git-config"},{"title":"Upload Source Code File","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /code-upload","href":"/api-reference/uploading-3rd-party-scan/upload-source-code-file"},{"title":"Upload CI/CD Data","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /ci-data-upload","href":"/api-reference/uploading-3rd-party-scan/upload-cicd-data"}]},{"group":"Skills","pages":[{"title":"List Skills","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /skills","href":"/api-reference/skills/list-skills"},{"title":"Get Skill","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /skills/{slug}","href":"/api-reference/skills/get-skill"}]},{"group":"Projects","pages":[{"title":"List Projects","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /projects","href":"/api-reference/projects/list-projects"},{"title":"Update Project Tags","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /projects/{project_id}/tags","href":"/api-reference/projects/update-project-tags"}]},{"group":"Policies","pages":[{"title":"List Blocking Rules","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /blocking-rules","href":"/api-reference/policies/list-blocking-rules"},{"title":"List Policies","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /policies","href":"/api-reference/policies/list-policies"},{"title":"Create Policy","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /policies","href":"/api-reference/policies/create-policy"},{"title":"Get Policy","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /policies/{policy_id}","href":"/api-reference/policies/get-policy"},{"title":"Deactivate Policy","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /policies/{policy_id}","href":"/api-reference/policies/deactivate-policy"},{"title":"Update Policy","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /policies/{policy_id}","href":"/api-reference/policies/update-policy"}]},{"group":"Notifications","pages":[{"title":"List Notification Types","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /notifications/types","href":"/api-reference/notifications/list-notification-types"},{"title":"List Notification Preferences","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /notifications/preferences","href":"/api-reference/notifications/list-notification-preferences"},{"title":"Update Notification Preference","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /notifications/preferences/{type_code}","href":"/api-reference/notifications/update-notification-preference"},{"title":"Update Notification Preference","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /notifications/preferences/{type_code}","href":"/api-reference/notifications/update-notification-preference-1"},{"title":"List Company Notification Defaults","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /notifications/company-defaults","href":"/api-reference/notifications/list-company-notification-defaults"},{"title":"Update Company Notification Default","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /notifications/company-defaults/{type_code}","href":"/api-reference/notifications/update-company-notification-default"},{"title":"Update Company Notification Default","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /notifications/company-defaults/{type_code}","href":"/api-reference/notifications/update-company-notification-default-1"}]},{"group":"Teams","pages":[{"title":"List teams","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /teams","href":"/api-reference/teams/list-teams"},{"title":"Create a team","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /teams","href":"/api-reference/teams/create-a-team"},{"title":"Get a team","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /teams/{team_id}","href":"/api-reference/teams/get-a-team"},{"title":"Delete a team","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /teams/{team_id}","href":"/api-reference/teams/delete-a-team"},{"title":"Update a team","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /teams/{team_id}","href":"/api-reference/teams/update-a-team"},{"title":"Add team members","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /teams/{team_id}/members","href":"/api-reference/teams/add-team-members"},{"title":"Remove team members","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /teams/{team_id}/members","href":"/api-reference/teams/remove-team-members"},{"title":"List projects accessible to a team","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /teams/{team_id}/projects","href":"/api-reference/teams/list-projects-accessible-to-a-team"}]},{"group":"Harness integrations","pages":[{"title":"List Harness integrations","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /integrations/harness","href":"/api-reference/harness-integrations/list-harness-integrations"},{"title":"Create a Harness integration","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /integrations/harness","href":"/api-reference/harness-integrations/create-a-harness-integration"},{"title":"Get a Harness integration","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /integrations/harness/{integration_uuid}","href":"/api-reference/harness-integrations/get-a-harness-integration"},{"title":"Delete a Harness integration","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /integrations/harness/{integration_uuid}","href":"/api-reference/harness-integrations/delete-a-harness-integration"},{"title":"Update a Harness integration","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /integrations/harness/{integration_uuid}","href":"/api-reference/harness-integrations/update-a-harness-integration"}]},{"group":"Users","pages":[{"title":"List users","description":"Lists company users, including inactive users. Requires `auth.view_user`. The default list and search exclude company admins, staff, and service principals. Exact, case-insensitive email lookup also includes company admins.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /users","href":"/api-reference/users/list-users"},{"title":"Create user","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /users","href":"/api-reference/users/create-user"},{"title":"Deactivate user","description":"Deactivates a company user without deleting the account, revokes active API tokens, and clears project access. Requires `auth.delete_user`. Company admins, staff, and service principals cannot be deactivated through this endpoint. Repeating the request for an inactive user succeeds.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /users/{user_id}","href":"/api-reference/users/deactivate-user"},{"title":"List roles","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /roles","href":"/api-reference/users/list-roles"}]}]}]},{"language":"de","navbar":{"links":[{"href":"mailto:help@corgea.com","label":"Support"}],"primary":{"type":"button","label":"Zu Corgea","href":"https://www.corgea.app"}},"pages":[{"title":"de","href":"/de/introduction"}]},{"language":"fr","navbar":{"links":[{"href":"mailto:help@corgea.com","label":"Assistance"}],"primary":{"type":"button","label":"Accéder à Corgea","href":"https://www.corgea.app"}},"pages":[{"title":"fr","href":"/fr/introduction"}]},{"language":"es","navbar":{"links":[{"href":"mailto:help@corgea.com","label":"Soporte"}],"primary":{"type":"button","label":"Ir a Corgea","href":"https://www.corgea.app"}},"pages":[{"title":"es","href":"/es/introduction"}]},{"language":"ja","navbar":{"links":[{"href":"mailto:help@corgea.com","label":"サポート"}],"primary":{"type":"button","label":"Corgeaを開く","href":"https://www.corgea.app"}},"pages":[{"title":"ja","href":"/ja/introduction"}]}]},"basePath":"","title":"Create user - Corgea Documentation","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CS552b7R.js","utils-DDTCYAF2.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-De8ttokP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DrwRDvAh.js","snippetPresets-DtAN0nWx.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-D5rWArI6.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-O2i12wsz.js","shallow-DV8xABTt.js","getApiPlaygroundDisplay-DBZ0B5Jx.js","CodeSnippet-BVi0tPUX.js","CodeSnippets-CqASbIwY.js","Page-m07pfKpT.js","getPastedJson-DG9vsMS8.js","icon-CXzRSCr8.js","MethodPill-BdKVtEuX.js","DuplicateIcon-CZlmBrJI.js","createIcon-biFEUKPL.js","DynamicMarkdown-B54_zNBF.js","SectionHeading-DwwHK3Pt.js","axios-vUo_bRtp.js","Markdown-DfhCTwyA.js","clsx-xpJZXxdP.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BTZUMDnx.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DqdKa2R4.js"]}