Cosmo by Humanizing provides secure authentication to protect your account and workspaces. You can sign in using email and password, a passwordless magic link, or try the platform anonymously.
Create a new account to get started with Cosmo by Humanizing.
1
Navigate to Sign Up
Go to the Sign Up page or click “Sign up” from the sign-in page.
2
Enter Your Details
Fill in the registration form:
Full Name - Your display name in the platform
Email - A valid email address for verification
Password - At least 8 characters
Confirm Password - Re-enter your password to confirm
3
Create Your Account
Click Sign Up to create your account. You’ll be redirected to a verification pending screen — check your email inbox for a verification link.
4
Verify Your Email
Click the verification link in your email to confirm your address. You will not be able to access the dashboard until your email is verified. If you don’t see the email, check your spam folder or use the Resend button on the verification screen.
Your password must be at least 8 characters long. Make sure both password fields match exactly.
If you’ve forgotten your password, you can reset it:
1
Go to Forgot Password
On the sign-in page, click Forgot password? to access the password reset page.
2
Enter Your Email
Enter your registered email address.
3
Request Reset Link
Click Send Reset Link. You’ll see a confirmation screen telling you to check your email — you are not redirected back to the sign-in page. If an account with that email exists, a password reset email will be sent.
4
Check Your Email
Open the password reset email and click the reset link.
5
Set New Password
Enter your new password (at least 8 characters) and confirm it. Click Reset Password to save.
Password reset links expire after a limited time for security. If your link has expired, request a new one.
Certain pages require authentication to access. If you try to visit these pages without being signed in, you’ll be automatically redirected to the sign-in page.
Route
Description
/dashboard
Your main workspace overview
/agents
Agent management and configuration
/onboarding
New agent creation wizard
/settings
Account and workspace settings
After signing in, you’ll be redirected back to your intended destination.
Make sure both the Password and Confirm Password fields contain exactly the same value. Passwords are case-sensitive.
Password too short error
Your password must be at least 8 characters long. Try a longer password that combines letters, numbers, and symbols.
Magic link not received
Check your spam or junk folder. If the email still doesn’t arrive after a few minutes, verify that you entered the correct email address and try again.
Account not found for magic link
Magic links only work for existing accounts. If you don’t have an account yet, use the Sign Up page to create one first.
Password reset link expired
Password reset links expire for security reasons. Request a new reset link from the forgot password page.
Email not verified error
Check your email inbox for a verification link. Click it to verify your email, then try signing in again.
Can't access protected pages
Protected pages require authentication. Sign in first, then try accessing the page again.
Email already registered
If you see “This email is already registered”, an account with that address already exists. Click Sign In in the notification or navigate to the sign-in page to access your account. Use Forgot password? if you don’t remember your password.
Invalid credentials error
If you see “Wrong email or password. Please try again.”, double-check your email and password. Use the Forgot password? link to reset if needed.
Account temporarily locked
After multiple failed login attempts, your account may be temporarily locked. Wait a few minutes before trying again.
Email not yet verified
If you see a message about verifying your email, check your inbox for the verification link and click it before signing in.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Cosmo by Humanizing","colors":{"primary":"#16A34A","light":"#07C983","dark":"#15803D"},"logo":{"light":"https://mintcdn.com/humanizing/vXIA-nG1DWKY8KEg/logo/light.svg?fit=max\u0026auto=format\u0026n=vXIA-nG1DWKY8KEg\u0026q=85\u0026s=327a2d665546795d1268ab8d559ba13e","dark":"https://mintcdn.com/humanizing/vXIA-nG1DWKY8KEg/logo/dark.svg?fit=max\u0026auto=format\u0026n=vXIA-nG1DWKY8KEg\u0026q=85\u0026s=b05e29ca34631e2c45fa9aa8c8f50332"},"favicon":"https://mintcdn.com/humanizing/rOwilB0IxZpVC5mt/favicon.png?fit=max\u0026auto=format\u0026n=rOwilB0IxZpVC5mt\u0026q=85\u0026s=b85bf1770888a567c057f61556f09219","navbar":{"links":[{"href":"https://app.cosmo.humanizing.com/support","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.cosmo.humanizing.com"}},"footer":{},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Dashboard","icon":"browser","href":"https://app.cosmo.humanizing.com"},{"anchor":"Support","icon":"headset","href":"https://app.cosmo.humanizing.com/support"}]},"languages":[{"language":"en","href":"getting-started/authentication"},{"language":"de","href":"de/getting-started/authentication"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"humanizing","hasAudioNarration":false,"actualSubdomain":"humanizing","customDomains":["docs.cosmo.humanizing.com"],"gitSource":{"type":"github","owner":"humanizing","repo":"humanizing-agents-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a90d30c253ad1bd38380081","collectionId":"53441b1d-f7ac-477f-ae1b-76e7a95992e4","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6a90d30c253ad1bd38380081"},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6a90d30c253ad1bd38380081","clientVersion":"0.0.3926","searchFilterCounts":[{"language":"en","tag":"User Guide","count":30},{"language":"de","tag":"Benutzerhandbuch","count":29},{"language":"en","tag":"Chatbot","count":13},{"language":"de","tag":"Chatbot","count":13},{"language":"en","tag":"Kiosk Avatar","count":6},{"language":"de","tag":"Kiosk Avatar","count":5},{"language":"en","tag":"Workspace \u0026 Account","count":4},{"language":"en","tag":"Chat Widget","count":4},{"language":"en","tag":"Features","count":4},{"language":"en","tag":"Getting Started","count":4},{"language":"en","tag":"Voicebot","count":4},{"language":"de","tag":"Workspace \u0026 Konto","count":4},{"language":"de","tag":"Chat-Widget","count":4},{"language":"de","tag":"Funktionen","count":4},{"language":"de","tag":"Erste Schritte","count":4},{"language":"de","tag":"Voicebot","count":4},{"language":"en","tag":"Data Protection \u0026 GDPR","count":3},{"language":"en","tag":"Workspace","count":3},{"language":"de","tag":"Datenschutz \u0026 DSGVO","count":3},{"language":"de","tag":"Workspace","count":3},{"language":"default","tag":"Änderungsprotokoll","count":1},{"language":"default","tag":"Updates","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"hasChatPermissions":false,"hasWebMcpPermissions":false,"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":"editor-v7-file-tree","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":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"editor-nav-generations","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":"vite-origin","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":"editor-agent-model-picker","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}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"getting-started/authentication","slug":"/getting-started/authentication","pageMetadata":{"title":"Authentication","description":"Learn how to sign up, sign in, and manage your account access","icon":"key","href":"/getting-started/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: \"Learn how to sign up, sign in, and manage your account access\"\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`,ol:`ol`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Accordion,AccordionGroup,Card,CardGroup,Heading,Note,Step,Steps,Table,Tip,Warning}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!AccordionGroup)_missingMdxReference(`AccordionGroup`,true);if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`overview`,children:`Overview`}),`\n`,_jsx(_components.p,{children:`Cosmo by Humanizing provides secure authentication to protect your account and workspaces. You can sign in using email and password, a passwordless magic link, or try the platform anonymously.`}),`\n`,_jsx(Heading,{level:`2`,id:`sign-up`,children:`Sign Up`}),`\n`,_jsx(_components.p,{children:`Create a new account to get started with Cosmo by Humanizing.`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Navigate to Sign Up`,children:_jsxs(_components.p,{children:[`Go to the `,_jsx(_components.strong,{children:`Sign Up`}),` page or click “Sign up” from the sign-in page.`]})}),_jsxs(Step,{title:`Enter Your Details`,children:[_jsx(_components.p,{children:`Fill in the registration form:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Full Name`}),` - Your display name in the platform`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Email`}),` - A valid email address for verification`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Password`}),` - At least 8 characters`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Confirm Password`}),` - Re-enter your password to confirm`]}),`\n`]})]}),_jsx(Step,{title:`Create Your Account`,children:_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Sign Up`}),` to create your account. You’ll be redirected to a verification pending screen — check your email inbox for a verification link.`]})}),_jsx(Step,{title:`Verify Your Email`,children:_jsxs(_components.p,{children:[`Click the verification link in your email to confirm your address. You will not be able to access the dashboard until your email is verified. If you don’t see the email, check your spam folder or use the `,_jsx(_components.strong,{children:`Resend`}),` button on the verification screen.`]})})]}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`Your password must be at least 8 characters long. Make sure both password fields match exactly.`})}),`\n`,_jsx(Heading,{level:`3`,id:`invitation-sign-up`,children:`Invitation Sign Up`}),`\n`,_jsx(_components.p,{children:`If you’ve been invited to join a workspace, you’ll receive an email with a special invitation link:`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`Click the invitation link in your email`}),`\n`,_jsx(_components.li,{children:`If you don’t have an account, you’ll be directed to sign up with your email pre-filled`}),`\n`,_jsx(_components.li,{children:`Complete the sign-up form`}),`\n`,_jsx(_components.li,{children:`After signing up, you’ll automatically join the workspace`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`sign-in`,children:`Sign In`}),`\n`,_jsx(_components.p,{children:`Access your account using one of three authentication methods.`}),`\n`,_jsx(Heading,{level:`3`,id:`password-sign-in`,children:`Password Sign In`}),`\n`,_jsx(_components.p,{children:`The default method using your email and password:`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Go to Sign In`,children:_jsxs(_components.p,{children:[`Navigate to the `,_jsx(_components.strong,{children:`Sign In`}),` page.`]})}),_jsx(Step,{title:`Select Password Tab`,children:_jsxs(_components.p,{children:[`Click the `,_jsx(_components.strong,{children:`Password`}),` tab (selected by default).`]})}),_jsx(Step,{title:`Enter Credentials`,children:_jsxs(_components.p,{children:[`Enter your registered `,_jsx(_components.strong,{children:`Email`}),` address and `,_jsx(_components.strong,{children:`Password`}),`.`]})}),_jsx(Step,{title:`Sign In`,children:_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Sign In`}),` to access your account. You’ll be redirected to your dashboard or agents page.`]})})]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`If you’ve forgotten your password, click the `,_jsx(_components.strong,{children:`Forgot password?`}),` link below the form.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`magic-link-sign-in`,children:`Magic Link Sign In`}),`\n`,_jsx(_components.p,{children:`For passwordless authentication, use the magic link option:`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Select Magic Link Tab`,children:_jsxs(_components.p,{children:[`On the sign-in page, click the `,_jsx(_components.strong,{children:`Magic Link`}),` tab.`]})}),_jsx(Step,{title:`Enter Your Email`,children:_jsx(_components.p,{children:`Enter the email address associated with your account.`})}),_jsx(Step,{title:`Send Magic Link`,children:_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Send Magic Link`}),`. You’ll see a confirmation message.`]})}),_jsx(Step,{title:`Check Your Email`,children:_jsx(_components.p,{children:`Open your email and click the magic link to sign in instantly. The link will redirect you to your dashboard.`})})]}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`Magic links are single-use and expire after a short period. If your link doesn’t work, request a new one.`})}),`\n`,_jsx(Heading,{level:`3`,id:`anonymous-sign-in`,children:`Anonymous Sign In`}),`\n`,_jsx(_components.p,{children:`Try the platform without creating a full account:`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Select Anonymous Tab`,children:_jsxs(_components.p,{children:[`On the sign-in page, click the `,_jsx(_components.strong,{children:`Anonymous`}),` tab.`]})}),_jsx(Step,{title:`Continue Anonymously`,children:_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Continue Anonymously`}),` to create a temporary session.`]})})]}),`\n`,_jsx(_components.p,{children:`Anonymous sessions allow you to explore the platform before committing to registration. You can link your anonymous session to a full account later.`}),`\n`,_jsx(Heading,{level:`2`,id:`password-reset`,children:`Password Reset`}),`\n`,_jsx(_components.p,{children:`If you’ve forgotten your password, you can reset it:`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Go to Forgot Password`,children:_jsxs(_components.p,{children:[`On the sign-in page, click `,_jsx(_components.strong,{children:`Forgot password?`}),` to access the password reset page.`]})}),_jsx(Step,{title:`Enter Your Email`,children:_jsx(_components.p,{children:`Enter your registered email address.`})}),_jsx(Step,{title:`Request Reset Link`,children:_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Send Reset Link`}),`. You’ll see a confirmation screen telling you to check your email — you are not redirected back to the sign-in page. If an account with that email exists, a password reset email will be sent.`]})}),_jsx(Step,{title:`Check Your Email`,children:_jsx(_components.p,{children:`Open the password reset email and click the reset link.`})}),_jsx(Step,{title:`Set New Password`,children:_jsxs(_components.p,{children:[`Enter your new password (at least 8 characters) and confirm it. Click `,_jsx(_components.strong,{children:`Reset Password`}),` to save.`]})})]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Password reset links expire after a limited time for security. If your link has expired, request a new one.`})}),`\n`,_jsx(Heading,{level:`2`,id:`protected-routes`,children:`Protected Routes`}),`\n`,_jsx(_components.p,{children:`Certain pages require authentication to access. If you try to visit these pages without being signed in, you’ll be automatically redirected to the sign-in page.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Route`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`/dashboard`})}),_jsx(_components.td,{children:`Your main workspace overview`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`/agents`})}),_jsx(_components.td,{children:`Agent management and configuration`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`/onboarding`})}),_jsx(_components.td,{children:`New agent creation wizard`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`/settings`})}),_jsx(_components.td,{children:`Account and workspace settings`})]})]})]}),`\n`,_jsx(_components.p,{children:`After signing in, you’ll be redirected back to your intended destination.`}),`\n`,_jsx(Heading,{level:`2`,id:`session-management`,children:`Session Management`}),`\n`,_jsx(_components.p,{children:`Your session remains active until you sign out or it expires. For security:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Sessions are stored securely as HTTP-only cookies`}),`\n`,_jsx(_components.li,{children:`You can sign out from any page using the account menu`}),`\n`,_jsx(_components.li,{children:`Signing in from a new device creates a new session`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`troubleshooting`,children:`Troubleshooting`}),`\n`,_jsxs(AccordionGroup,{children:[_jsx(Accordion,{icon:`circle-xmark`,title:`Passwords don't match error`,id:`passwords-dont-match-error`,children:_jsx(_components.p,{children:`Make sure both the Password and Confirm Password fields contain exactly the same value. Passwords are case-sensitive.`})}),_jsx(Accordion,{icon:`lock`,title:`Password too short error`,id:`password-too-short-error`,children:_jsx(_components.p,{children:`Your password must be at least 8 characters long. Try a longer password that combines letters, numbers, and symbols.`})}),_jsx(Accordion,{icon:`envelope`,title:`Magic link not received`,id:`magic-link-not-received`,children:_jsx(_components.p,{children:`Check your spam or junk folder. If the email still doesn’t arrive after a few minutes, verify that you entered the correct email address and try again.`})}),_jsx(Accordion,{icon:`user-xmark`,title:`Account not found for magic link`,id:`account-not-found-for-magic-link`,children:_jsx(_components.p,{children:`Magic links only work for existing accounts. If you don’t have an account yet, use the Sign Up page to create one first.`})}),_jsx(Accordion,{icon:`key`,title:`Password reset link expired`,id:`password-reset-link-expired`,children:_jsx(_components.p,{children:`Password reset links expire for security reasons. Request a new reset link from the forgot password page.`})}),_jsx(Accordion,{icon:`circle-exclamation`,title:`Email not verified error`,id:`email-not-verified-error`,children:_jsx(_components.p,{children:`Check your email inbox for a verification link. Click it to verify your email, then try signing in again.`})}),_jsx(Accordion,{icon:`right-to-bracket`,title:`Can't access protected pages`,id:`cant-access-protected-pages`,children:_jsx(_components.p,{children:`Protected pages require authentication. Sign in first, then try accessing the page again.`})}),_jsx(Accordion,{icon:`user-check`,title:`Email already registered`,id:`email-already-registered`,children:_jsxs(_components.p,{children:[`If you see “This email is already registered”, an account with that address already exists. Click `,_jsx(_components.strong,{children:`Sign In`}),` in the notification or navigate to the sign-in page to access your account. Use `,_jsx(_components.strong,{children:`Forgot password?`}),` if you don’t remember your password.`]})}),_jsx(Accordion,{icon:`circle-xmark`,title:`Invalid credentials error`,id:`invalid-credentials-error`,children:_jsxs(_components.p,{children:[`If you see “Wrong email or password. Please try again.”, double-check your email and password. Use the `,_jsx(_components.strong,{children:`Forgot password?`}),` link to reset if needed.`]})}),_jsx(Accordion,{icon:`clock`,title:`Account temporarily locked`,id:`account-temporarily-locked`,children:_jsx(_components.p,{children:`After multiple failed login attempts, your account may be temporarily locked. Wait a few minutes before trying again.`})}),_jsx(Accordion,{icon:`envelope-open`,title:`Email not yet verified`,id:`email-not-yet-verified`,children:_jsx(_components.p,{children:`If you see a message about verifying your email, check your inbox for the verification link and click it before signing in.`})})]}),`\n`,_jsx(Heading,{level:`2`,id:`security-best-practices`,children:`Security Best Practices`}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`Use Strong Passwords`,icon:`lock`,children:_jsx(_components.p,{children:`Create passwords with at least 8 characters. Use a mix of letters, numbers, and symbols.`})}),_jsx(Card,{title:`Keep Email Secure`,icon:`envelope`,children:_jsx(_components.p,{children:`Your email is used for password resets and magic links. Keep your email account secure.`})}),_jsx(Card,{title:`Don't Share Credentials`,icon:`user-shield`,children:_jsx(_components.p,{children:`Never share your password or magic links. Use workspace invitations for team access.`})}),_jsx(Card,{title:`Sign Out When Done`,icon:`right-from-bracket`,children:_jsx(_components.p,{children:`Always sign out when using shared or public computers.`})})]}),`\n`,_jsx(Heading,{level:`2`,id:`next-steps`,children:`Next Steps`}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`Create Workspace`,icon:`briefcase`,href:`/getting-started/create-workspace`,children:_jsx(_components.p,{children:`Set up your first workspace after signing in.`})}),_jsx(Card,{title:`Create Agent`,icon:`robot`,href:`/agents/overview`,children:_jsx(_components.p,{children:`Learn how to create your first AI agent.`})})]})]})}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":"Learn how to sign up, sign in, and manage your account access","icon":"key","href":"/getting-started/authentication"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Overview","slug":"overview","depth":2,"children":[]},{"title":"Sign Up","slug":"sign-up","depth":2,"children":[{"title":"Invitation Sign Up","slug":"invitation-sign-up","depth":3,"children":[]}]},{"title":"Sign In","slug":"sign-in","depth":2,"children":[{"title":"Password Sign In","slug":"password-sign-in","depth":3,"children":[]},{"title":"Magic Link Sign In","slug":"magic-link-sign-in","depth":3,"children":[]},{"title":"Anonymous Sign In","slug":"anonymous-sign-in","depth":3,"children":[]}]},{"title":"Password Reset","slug":"password-reset","depth":2,"children":[]},{"title":"Protected Routes","slug":"protected-routes","depth":2,"children":[]},{"title":"Session Management","slug":"session-management","depth":2,"children":[]},{"title":"Troubleshooting","slug":"troubleshooting","depth":2,"children":[]},{"title":"Security Best Practices","slug":"security-best-practices","depth":2,"children":[]},{"title":"Next Steps","slug":"next-steps","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"humanizing","siteName":"Cosmo by Humanizing","title":"Authentication - Cosmo by Humanizing","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/getting-started/authentication","matchLevel":0},"de":{"href":"/de/getting-started/authentication","matchLevel":1}}},"lastModified":"2026-05-26T23:51:38.071Z","originalFileLocation":"getting-started/authentication.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=\"Learn how to sign up, sign in, and manage your account access\">\u003cmeta data-mint-head name=\"application-name\" content=\"Cosmo by Humanizing\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/humanizing/vYgQ1J24qlSzLSa0/_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/humanizing/vYgQ1J24qlSzLSa0/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/humanizing/vYgQ1J24qlSzLSa0/_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/humanizing/vYgQ1J24qlSzLSa0/_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/humanizing/vYgQ1J24qlSzLSa0/_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/humanizing/vYgQ1J24qlSzLSa0/_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/humanizing/vYgQ1J24qlSzLSa0/_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/humanizing/vYgQ1J24qlSzLSa0/_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/humanizing/vYgQ1J24qlSzLSa0/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Authentication - Cosmo by Humanizing\">\u003cmeta data-mint-head property=\"og:description\" content=\"Learn how to sign up, sign in, and manage your account access\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Cosmo by Humanizing\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.cosmo.humanizing.com/getting-started/authentication\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://humanizing.mintlify.app/_mintlify/api/og/v2?division=Getting+Started\u0026amp;title=Authentication\u0026amp;description=Learn+how+to+sign+up%2C+sign+in%2C+and+manage+your+account+access\u0026amp;theme=6d943b69b7870c01ab778c5c\u0026amp;signature=9b41f98ab996e9ad359cf0066165f1c4dc83c2a07f5bd7a3fdb274f832a7dfb8\">\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 - Cosmo by Humanizing\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Learn how to sign up, sign in, and manage your account access\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://humanizing.mintlify.app/_mintlify/api/og/v2?division=Getting+Started\u0026amp;title=Authentication\u0026amp;description=Learn+how+to+sign+up%2C+sign+in%2C+and+manage+your+account+access\u0026amp;theme=6d943b69b7870c01ab778c5c\u0026amp;signature=9b41f98ab996e9ad359cf0066165f1c4dc83c2a07f5bd7a3fdb274f832a7dfb8\">\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/humanizing/vYgQ1J24qlSzLSa0/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Cosmo by Humanizing\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#16A34A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.cosmo.humanizing.com/getting-started/authentication\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/getting-started/authentication.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.cosmo.humanizing.com/getting-started/authentication\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"de\" href=\"https://docs.cosmo.humanizing.com/de/getting-started/authentication\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.cosmo.humanizing.com/getting-started/authentication\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.cosmo.humanizing.com/#organization\",\"name\":\"Cosmo by Humanizing\",\"url\":\"https://docs.cosmo.humanizing.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/humanizing/vXIA-nG1DWKY8KEg/logo/light.svg?fit=max\u0026auto=format\u0026n=vXIA-nG1DWKY8KEg\u0026q=85\u0026s=327a2d665546795d1268ab8d559ba13e\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.cosmo.humanizing.com#website\",\"name\":\"Cosmo by Humanizing\",\"url\":\"https://docs.cosmo.humanizing.com\",\"publisher\":{\"@id\":\"https://docs.cosmo.humanizing.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.cosmo.humanizing.com/getting-started/authentication#webpage\",\"url\":\"https://docs.cosmo.humanizing.com/getting-started/authentication\",\"name\":\"Authentication\",\"description\":\"Learn how to sign up, sign in, and manage your account access\",\"dateModified\":\"2026-05-26T23:51:38.071Z\",\"isPartOf\":{\"@id\":\"https://docs.cosmo.humanizing.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.cosmo.humanizing.com/getting-started/authentication#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.cosmo.humanizing.com/getting-started/authentication#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Cosmo by Humanizing\",\"item\":\"https://docs.cosmo.humanizing.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Authentication\",\"item\":\"https://docs.cosmo.humanizing.com/getting-started/authentication\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.cosmo.humanizing.com/getting-started/authentication#article\",\"headline\":\"Authentication\",\"name\":\"Authentication\",\"description\":\"Learn how to sign up, sign in, and manage your account access\",\"url\":\"https://docs.cosmo.humanizing.com/getting-started/authentication\",\"mainEntityOfPage\":{\"@id\":\"https://docs.cosmo.humanizing.com/getting-started/authentication#webpage\"},\"dateModified\":\"2026-05-26T23:51:38.071Z\",\"publisher\":{\"@id\":\"https://docs.cosmo.humanizing.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.cosmo.humanizing.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Cosmo by Humanizing\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Cosmo by Humanizing","nav":{"global":{"anchors":[{"anchor":"Dashboard","icon":"browser","href":"https://app.cosmo.humanizing.com"},{"anchor":"Support","icon":"headset","href":"https://app.cosmo.humanizing.com/support"}]},"languages":[{"language":"en","tabs":[{"tab":"User Guide","groups":[{"group":"Getting Started","pages":[{"title":"Authentication","icon":"key","href":"/getting-started/authentication"},{"title":"Create a Workspace","description":"Learn how to create and manage workspaces to organize your AI agents and team members","icon":"briefcase","href":"/getting-started/create-workspace"},{"title":"Getting Started","icon":"rocket","href":"/quickstart"},{"title":"Welcome to Cosmo by Humanizing","icon":"hand-wave","href":"/index"}]},{"group":"Data Protection \u0026 GDPR","pages":[{"title":"Data Protection \u0026 GDPR","icon":"shield-check","href":"/data-protection/overview"},{"title":"Privacy Notice Template","icon":"file-lines","href":"/data-protection/privacy-notice-template"},{"title":"Request an AVV (DPA)","icon":"file-signature","href":"/data-protection/avv"}]},{"group":"Voicebot","pages":[{"title":"Phone Numbers","icon":"sim-card","href":"/voicebot/phone-numbers"},{"title":"Voicebot Installation","icon":"phone-volume","href":"/voicebot/deployment"},{"title":"Voicebot Overview","icon":"phone","href":"/voicebot/overview"},{"title":"Voicebot Playground","icon":"flask","href":"/voicebot/playground"}]},{"group":"Chatbot","pages":[{"title":"Analytics","icon":"chart-line","href":"/agents/analytics"},{"title":"Chatbot Overview","icon":"message","href":"/agents/overview"},{"title":"Deployment","icon":"rocket","href":"/agents/deployment"},{"title":"Knowledge Sources Overview","icon":"database","href":"/sources/overview"},{"title":"Localization \u0026 Language","icon":"globe","href":"/customization/localization"},{"title":"Onboarding","icon":"wand-magic-sparkles","href":"/agents/onboarding"},{"title":"Playground","icon":"flask","href":"/agents/playground"},{"title":"Q\u0026A Sources","icon":"circle-question","href":"/sources/qa-sources"},{"title":"Styling \u0026 Appearance","icon":"palette","href":"/customization/styling"},{"title":"Text Sources","icon":"file-lines","href":"/sources/text-sources"},{"title":"Viewing Conversations","icon":"messages","href":"/agents/conversations"},{"title":"Web Sources","icon":"globe","href":"/sources/web-sources"},{"title":"Widget Configuration","icon":"sliders","href":"/customization/widget"}]},{"group":"Kiosk Avatar","pages":[{"title":"Analytics","icon":"chart-line","href":"/receptionist/analytics"},{"title":"Kiosk Avatar Onboarding","icon":"wand-magic-sparkles","href":"/receptionist/onboarding"},{"title":"Kiosk Avatar Overview","icon":"building","href":"/receptionist/overview"},{"title":"Kiosk Deployment","icon":"rocket","href":"/receptionist/deployment"},{"title":"Kiosk Styling","icon":"palette","href":"/receptionist/styling"},{"title":"Managing Contacts","icon":"address-book","href":"/receptionist/contacts"}]}]},{"tab":"Workspace \u0026 Account","pages":[{"title":"Workspace \u0026 Account","href":"/workspace/billing"}]},{"tab":"Chat Widget","pages":[{"title":"Chat Widget","href":"/chat-widget/overview"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]}]},{"language":"de","pages":[{"title":"de","href":"/de/getting-started/authentication"}]}]},"title":"Authentication - Cosmo by Humanizing","buildId":"dpl_9DauxEjb9gzCtcuhPQFbquJvx7FJ","deploymentId":"dpl_9DauxEjb9gzCtcuhPQFbquJvx7FJ","dynamics":[],"chunks":[]}