Admin-only callback endpoint for the mail system to register or rotate tenant credentials for a Voice team
mail-tenant-credentials is an admin-only resource that lets the mail system push the credentials it issued (or reissued) for a Voice team back into HelpGenie Voice. It is the inbound counterpart to the outbound tenant-provisioning call made when a genie mailbox is first created.If the owner_email address has no Voice account yet, one is created automatically. If that account has no team, a team is created as well — so the mail system always receives a stable team_id to store on its side.
All actions on this resource require an internal admin API key. Requests from non-admin callers are rejected with 403 Forbidden.
Upsert tenant credentials
Registers or updates the mail tenant credentials for the team that owns owner_email. Creates a Voice account and team for owner_email if neither exists yet.
string
required
Must be "mail-tenant-credentials"
string
required
Must be "upsert"
object
required
Show properties
string
required
Email address of the Voice team owner. Must be a valid email address. Used to look up (or create) the Voice account that owns the tenant.
string
required
The tenant identifier issued by the mail system for this team.
string
required
The API key issued by the mail system for this tenant.
string | null
Display name for the tenant. Pass null to clear an existing value.
string | null
The mail system’s own user identifier for this owner. Pass null if not available.
boolean
Whether the credentials were stored successfully.
object
Show properties
number
The Voice team ID the credentials were stored under. The mail system should persist this to associate future updates with the same team.
string
The Voice user ID for owner_email. Matches the ID of the newly created account if one was provisioned during this call.
If owner_email does not match any existing Voice account, a new account is created with a temporary password. The owner will need to complete account setup before logging in directly.
If the resolved account has no team, a team is created automatically using the local part of owner_email as the team name.
Calling upsert again for the same owner_email with new credentials will overwrite the previously stored values — no duplicate entries are created.
Error codes
Code
Status
Description
FORBIDDEN
403
Caller is not an internal admin
VALIDATION_ERROR
400
owner_email is missing or invalid, tenant_id is missing, or api_key is missing
INVALID_ACTION
400
Unknown action
INTERNAL_ERROR
500
Account or team creation failed, or credential storage failed
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Help Genie","description":"API documentation for the Help Genie voice AI platform","colors":{"primary":"#4E9CFF","light":"#7BB8FF","dark":"#2B7FE8"},"logo":{"light":"https://mintcdn.com/helpgenie/a134Jyg1BOpqw0vP/logo/light.png?fit=max\u0026auto=format\u0026n=a134Jyg1BOpqw0vP\u0026q=85\u0026s=f29d097a201254a8a750843d0d692c50","dark":"https://mintcdn.com/helpgenie/a134Jyg1BOpqw0vP/logo/dark.png?fit=max\u0026auto=format\u0026n=a134Jyg1BOpqw0vP\u0026q=85\u0026s=f00cbee677f1f3a3f46d463cb7cbad38","href":"https://helpgenie.ai"},"favicon":"https://mintcdn.com/helpgenie/17V8AwVjtycIuhCm/favicon.svg?fit=max\u0026auto=format\u0026n=17V8AwVjtycIuhCm\u0026q=85\u0026s=8a7865e1c10e3dacc378789f70f5ef6e","navbar":{"links":[{"href":"mailto:support@helpgenie.ai","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://helpgenie.ai/dashboard"}},"footer":{"socials":{"linkedin":"https://linkedin.com/company/helpgenie"}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Help Genie Voice","icon":"microphone","href":"https://helpgenie.ai"},{"anchor":"Help Genie Mail","icon":"envelope","href":"https://mail.helpgenie.ai"},{"anchor":"Help Genie Outbound","icon":"phone","href":"https://outbound.helpgenie.ai"},{"anchor":"Help Genie Sync","icon":"arrows-rotate","href":"https://sync.helpgenie.ai"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"helpgenie","hasAudioNarration":false,"actualSubdomain":"helpgenie","customDomains":["docs.helpgenie.ai"],"gitSource":{"type":"github","owner":"help-genie-ai","repo":"help-genie-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6af6f87607e6a796f0fd81d2","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API reference","count":54},{"language":"default","tag":"Voice","count":37},{"language":"default","tag":"Overview","count":20},{"language":"default","tag":"Expanded Platform","count":16},{"language":"default","tag":"Sync","count":13},{"language":"default","tag":"Mail","count":11},{"language":"default","tag":"Outbound","count":9},{"language":"default","tag":"Knowledge","count":6},{"language":"default","tag":"Working with mail","count":6},{"language":"default","tag":"Configuring a Genie","count":6}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"api-reference/mail-tenant-credentials","slug":"/api-reference/mail-tenant-credentials","pageMetadata":{"title":"Mail tenant credentials","description":"Admin-only callback endpoint for the mail system to register or rotate tenant credentials for a Voice team","href":"/api-reference/mail-tenant-credentials"},"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: \"Admin-only callback endpoint for the mail system to register or rotate tenant credentials for a Voice team\"\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`,hr:`hr`,li:`li`,p:`p`,pre:`pre`,span:`span`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,CodeGroup,Expandable,Heading,ParamField,ResponseField,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[_jsx(_components.code,{children:`mail-tenant-credentials`}),` is an admin-only resource that lets the mail system push the credentials it issued (or reissued) for a Voice team back into HelpGenie Voice. It is the inbound counterpart to the outbound tenant-provisioning call made when a genie mailbox is first created.`]}),`\n`,_jsxs(_components.p,{children:[`If the `,_jsx(_components.code,{children:`owner_email`}),` address has no Voice account yet, one is created automatically. If that account has no team, a team is created as well — so the mail system always receives a stable `,_jsx(_components.code,{children:`team_id`}),` to store on its side.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`All actions on this resource require an internal admin API key. Requests from non-admin callers are rejected with `,_jsx(_components.code,{children:`403 Forbidden`}),`.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`upsert-tenant-credentials`,children:`Upsert tenant credentials`}),`\n`,_jsxs(_components.p,{children:[`Registers or updates the mail tenant credentials for the team that owns `,_jsx(_components.code,{children:`owner_email`}),`. Creates a Voice account and team for `,_jsx(_components.code,{children:`owner_email`}),` if neither exists yet.`]}),`\n`,_jsx(ParamField,{body:`resource`,type:`string`,required:true,id:`param-resource`,children:_jsxs(_components.p,{children:[`Must be `,_jsx(_components.code,{children:`\"mail-tenant-credentials\"`})]})}),`\n`,_jsx(ParamField,{body:`action`,type:`string`,required:true,id:`param-action`,children:_jsxs(_components.p,{children:[`Must be `,_jsx(_components.code,{children:`\"upsert\"`})]})}),`\n`,_jsx(ParamField,{body:`data`,type:`object`,required:true,id:`param-data`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ParamField,{body:`owner_email`,type:`string`,required:true,id:`param-owner-email`,children:_jsx(_components.p,{children:`Email address of the Voice team owner. Must be a valid email address. Used to look up (or create) the Voice account that owns the tenant.`})}),_jsx(ParamField,{body:`tenant_id`,type:`string`,required:true,id:`param-tenant-id`,children:_jsx(_components.p,{children:`The tenant identifier issued by the mail system for this team.`})}),_jsx(ParamField,{body:`api_key`,type:`string`,required:true,id:`param-api-key`,children:_jsx(_components.p,{children:`The API key issued by the mail system for this tenant.`})}),_jsx(ParamField,{body:`tenant_name`,type:`string | null`,id:`param-tenant-name`,children:_jsxs(_components.p,{children:[`Display name for the tenant. Pass `,_jsx(_components.code,{children:`null`}),` to clear an existing value.`]})}),_jsx(ParamField,{body:`owner_user_id`,type:`string | null`,id:`param-owner-user-id`,children:_jsxs(_components.p,{children:[`The mail system’s own user identifier for this owner. Pass `,_jsx(_components.code,{children:`null`}),` if not available.`]})})]})}),`\n`,_jsx(ResponseField,{name:`success`,type:`boolean`,id:`param-success`,children:_jsx(_components.p,{children:`Whether the credentials were stored successfully.`})}),`\n`,_jsx(ResponseField,{name:`data`,type:`object`,id:`param-data-1`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ResponseField,{name:`team_id`,type:`number`,id:`param-team-id`,children:_jsx(_components.p,{children:`The Voice team ID the credentials were stored under. The mail system should persist this to associate future updates with the same team.`})}),_jsx(ResponseField,{name:`owner_user_id`,type:`string`,id:`param-owner-user-id-1`,children:_jsxs(_components.p,{children:[`The Voice user ID for `,_jsx(_components.code,{children:`owner_email`}),`. Matches the ID of the newly created account if one was provisioned during this call.`]})})]})}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`ApiService.invoke()`,numberOfLines:`16`,language:`typescript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`typescript`,children:_jsxs(_components.code,{language:`typescript`,numberOfLines:`16`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` response`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` ApiService`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`invoke`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`\u003c{`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` team_id`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:` number`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`;`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` owner_user_id`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:` string`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`;`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}>({`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` resource:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"mail-tenant-credentials\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` action:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"upsert\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` data:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` owner_email:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"owner@example.com\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` tenant_id:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"tenant-abc123\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` api_key:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"mk_live_xxxxxxxxxxxxxxxx\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` tenant_name:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Example Team\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` owner_user_id:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"mail-usr-456\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:`team_id`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:`owner_user_id`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` } `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` response`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`;`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`14`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`14`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.helpgenie.ai/v1`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer hg_live_YOUR_ADMIN_KEY\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"resource\": \"mail-tenant-credentials\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"action\": \"upsert\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"data\": {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"owner_email\": \"owner@example.com\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"tenant_id\": \"tenant-abc123\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"api_key\": \"mk_live_xxxxxxxxxxxxxxxx\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"tenant_name\": \"Example Team\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"owner_user_id\": \"mail-usr-456\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`Response`,numberOfLines:`7`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`7`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"success\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"team_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`42`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"owner_user_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"550e8400-e29b-41d4-a716-446655440000\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`side-effects`,children:`Side effects`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`If `,_jsx(_components.code,{children:`owner_email`}),` does not match any existing Voice account, a new account is created with a temporary password. The owner will need to complete account setup before logging in directly.`]}),`\n`,_jsxs(_components.li,{children:[`If the resolved account has no team, a team is created automatically using the local part of `,_jsx(_components.code,{children:`owner_email`}),` as the team name.`]}),`\n`,_jsxs(_components.li,{children:[`Calling `,_jsx(_components.code,{children:`upsert`}),` again for the same `,_jsx(_components.code,{children:`owner_email`}),` with new credentials will overwrite the previously stored values — no duplicate entries are created.`]}),`\n`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`error-codes`,children:`Error codes`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Code`}),_jsx(_components.th,{children:`Status`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`FORBIDDEN`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`403`}),_jsx(_components.td,{children:`Caller is not an internal admin`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`VALIDATION_ERROR`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`owner_email`}),` is missing or invalid, `,_jsx(_components.code,{children:`tenant_id`}),` is missing, or `,_jsx(_components.code,{children:`api_key`}),` is missing`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`INVALID_ACTION`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:`Unknown action`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`INTERNAL_ERROR`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`500`}),_jsx(_components.td,{children:`Account or team creation failed, or credential storage failed`})]})]})]})]})}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":"Mail tenant credentials","description":"Admin-only callback endpoint for the mail system to register or rotate tenant credentials for a Voice team","href":"/api-reference/mail-tenant-credentials"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Upsert tenant credentials","slug":"upsert-tenant-credentials","depth":2,"children":[]},{"title":"Side effects","slug":"side-effects","depth":2,"children":[]},{"title":"Error codes","slug":"error-codes","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"helpgenie","siteName":"Help Genie","title":"Mail tenant credentials - Help Genie","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-07T06:34:27.073Z","originalFileLocation":"api-reference/mail-tenant-credentials.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=\"Admin-only callback endpoint for the mail system to register or rotate tenant credentials for a Voice team\">\u003cmeta data-mint-head name=\"application-name\" content=\"Help Genie\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/helpgenie/ypdPY4Ery9DMUCww/_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/helpgenie/ypdPY4Ery9DMUCww/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/helpgenie/ypdPY4Ery9DMUCww/_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/helpgenie/ypdPY4Ery9DMUCww/_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/helpgenie/ypdPY4Ery9DMUCww/_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/helpgenie/ypdPY4Ery9DMUCww/_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/helpgenie/ypdPY4Ery9DMUCww/_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/helpgenie/ypdPY4Ery9DMUCww/_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/helpgenie/ypdPY4Ery9DMUCww/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Mail tenant credentials - Help Genie\">\u003cmeta data-mint-head property=\"og:description\" content=\"Admin-only callback endpoint for the mail system to register or rotate tenant credentials for a Voice team\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Help Genie\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.helpgenie.ai/api-reference/mail-tenant-credentials\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://helpgenie.mintlify.site/_mintlify/api/og/v2?division=Expanded+Platform\u0026amp;title=Mail+tenant+credentials\u0026amp;description=Admin-only+callback+endpoint+for+the+mail+system+to+register+or+rotate+tenant+credentials+for+a+Voice+team\u0026amp;theme=fc0888b7de96c166e1873963\u0026amp;signature=9a67123e3b780634e7418a136dd86dd73a0bec16049af055e83ed08d117483a2\">\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=\"Mail tenant credentials - Help Genie\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Admin-only callback endpoint for the mail system to register or rotate tenant credentials for a Voice team\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://helpgenie.mintlify.site/_mintlify/api/og/v2?division=Expanded+Platform\u0026amp;title=Mail+tenant+credentials\u0026amp;description=Admin-only+callback+endpoint+for+the+mail+system+to+register+or+rotate+tenant+credentials+for+a+Voice+team\u0026amp;theme=fc0888b7de96c166e1873963\u0026amp;signature=9a67123e3b780634e7418a136dd86dd73a0bec16049af055e83ed08d117483a2\">\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/helpgenie/ypdPY4Ery9DMUCww/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Help Genie\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#4E9CFF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.helpgenie.ai/api-reference/mail-tenant-credentials\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/mail-tenant-credentials.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.helpgenie.ai/#organization\",\"name\":\"Help Genie\",\"url\":\"https://docs.helpgenie.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/helpgenie/a134Jyg1BOpqw0vP/logo/light.png?fit=max\u0026auto=format\u0026n=a134Jyg1BOpqw0vP\u0026q=85\u0026s=f29d097a201254a8a750843d0d692c50\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.helpgenie.ai#website\",\"name\":\"Help Genie\",\"url\":\"https://docs.helpgenie.ai\",\"publisher\":{\"@id\":\"https://docs.helpgenie.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.helpgenie.ai/api-reference/mail-tenant-credentials#webpage\",\"url\":\"https://docs.helpgenie.ai/api-reference/mail-tenant-credentials\",\"name\":\"Mail tenant credentials\",\"description\":\"Admin-only callback endpoint for the mail system to register or rotate tenant credentials for a Voice team\",\"dateModified\":\"2026-08-07T06:34:27.073Z\",\"isPartOf\":{\"@id\":\"https://docs.helpgenie.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.helpgenie.ai/api-reference/mail-tenant-credentials#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.helpgenie.ai/api-reference/mail-tenant-credentials#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Expanded Platform\",\"item\":\"https://docs.helpgenie.ai/api-reference/analytics\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mail tenant credentials\",\"item\":\"https://docs.helpgenie.ai/api-reference/mail-tenant-credentials\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.helpgenie.ai/api-reference/mail-tenant-credentials#article\",\"headline\":\"Mail tenant credentials\",\"name\":\"Mail tenant credentials\",\"description\":\"Admin-only callback endpoint for the mail system to register or rotate tenant credentials for a Voice team\",\"url\":\"https://docs.helpgenie.ai/api-reference/mail-tenant-credentials\",\"mainEntityOfPage\":{\"@id\":\"https://docs.helpgenie.ai/api-reference/mail-tenant-credentials#webpage\"},\"dateModified\":\"2026-08-07T06:34:27.073Z\",\"publisher\":{\"@id\":\"https://docs.helpgenie.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.helpgenie.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Help Genie\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Help Genie\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/mail-tenant-credentials.md","siteName":"Help Genie","nav":{"global":{"anchors":[{"anchor":"Help Genie Voice","icon":"microphone","href":"https://helpgenie.ai"},{"anchor":"Help Genie Mail","icon":"envelope","href":"https://mail.helpgenie.ai"},{"anchor":"Help Genie Outbound","icon":"phone","href":"https://outbound.helpgenie.ai"},{"anchor":"Help Genie Sync","icon":"arrows-rotate","href":"https://sync.helpgenie.ai"}]},"tabs":[{"tab":"Getting started","icon":"compass","pages":[{"title":"Getting started","href":""}]},{"tab":"API reference","icon":"code","groups":[{"group":"Overview","pages":[{"title":"API reference","href":"/api-reference/introduction"},{"title":"Authentication","href":"/api-reference/authentication"},{"title":"Making requests","href":"/api-reference/making-requests"},{"title":"Error handling","href":"/api-reference/errors"}]},{"group":"Public (unauthenticated)","pages":[{"title":"Public Genies","href":"/api-reference/public-genies"},{"title":"Public Help Hub","href":"/api-reference/public-help-hub"},{"title":"Activation (Public)","href":"/api-reference/activation"},{"title":"Help Hub","href":"/api-reference/help-hub"}]},{"group":"Agents","pages":[{"title":"Genies","href":"/api-reference/genies"},{"title":"Genie groups","href":"/api-reference/genie-groups"},{"title":"Conversations","href":"/api-reference/conversations"},{"title":"Genie Meetings","href":"/api-reference/genie-meetings"}]},{"group":"Knowledge","pages":[{"title":"Knowledge base","href":"/api-reference/knowledge-base"},{"title":"Knowledge Recommendations","href":"/api-reference/knowledge-recommendations"},{"title":"Document folders","href":"/api-reference/document-folders"},{"title":"Genie Documents","href":"/api-reference/genie-documents"}]},{"group":"CRM","pages":[{"title":"Leads","href":"/api-reference/leads"}]},{"group":"Marketplace","pages":[{"title":"Marketplace","href":"/api-reference/marketplace"}]},{"group":"Platform","pages":[{"title":"Profiles","href":"/api-reference/profiles"},{"title":"Teams","href":"/api-reference/teams"},{"title":"Activities","href":"/api-reference/activities"},{"title":"Goals","href":"/api-reference/goals"},{"title":"API keys","href":"/api-reference/api-keys"}]},{"group":"Telephony","pages":[{"title":"Phone numbers","href":"/api-reference/phone-numbers"},{"title":"QR codes","href":"/api-reference/qr-code"}]},{"group":"Worker genies","pages":[{"title":"Worker genies","href":"/api-reference/worker-genies"}]},{"group":"Quality \u0026 Compliance","pages":[{"title":"Brand Integrity","href":"/api-reference/brand-integrity"}]},{"group":"Access Control","pages":[{"title":"Genie Access","href":"/api-reference/genie-access"}]},{"group":"Intelligence","pages":[{"title":"Insights","href":"/api-reference/insights"}]},{"group":"Education","pages":[{"title":"Learn","href":"/api-reference/learn"}]},{"group":"Voice","pages":[{"title":"Voices","href":"/api-reference/voices"},{"title":"Voice collections","href":"/api-reference/voice-collections"},{"title":"Preselected voices","href":"/api-reference/preselected-voices"},{"title":"Pronunciation Vaults","href":"/api-reference/pronunciation-vaults"}]},{"group":"Integrations","pages":[{"title":"Context Sources","href":"/api-reference/context-sources"},{"title":"Escalation Webhooks","href":"/api-reference/escalation-webhooks"},{"title":"Chat channels","href":"/api-reference/chat-channels"},{"title":"MCP connections","href":"/api-reference/mcp-connections"}]},{"group":"Expanded Platform","pages":[{"title":"Analytics","href":"/api-reference/analytics"},{"title":"Billing","href":"/api-reference/billing"},{"title":"Branding","href":"/api-reference/branding"},{"title":"Portals","href":"/api-reference/portals"},{"title":"Activation Packs","href":"/api-reference/activation-packs"},{"title":"Print Orders","href":"/api-reference/print-orders"},{"title":"Playbooks","href":"/api-reference/playbooks"},{"title":"Demo Genies","href":"/api-reference/demo-genies"},{"title":"Email Templates","href":"/api-reference/email-templates"},{"title":"Email Logs","href":"/api-reference/email-logs"},{"title":"System Emails","href":"/api-reference/system-emails"},{"title":"Generate Logo","href":"/api-reference/generate-logo"},{"title":"Capabilities","href":"/api-reference/capabilities"},{"title":"Agent mailboxes","href":"/api-reference/agent-mailboxes"},{"title":"Genie mailbox (self)","description":"Owner-facing provisioning and management of your genie's email inbox","href":"/api-reference/agent-mailboxes-self"},{"title":"Mail tenant credentials","href":"/api-reference/mail-tenant-credentials"}]}]},{"tab":"Voice","icon":"microphone","pages":[{"title":"Voice","href":"/voice-guide/my-genies-list"}]},{"tab":"Mail","icon":"envelope","pages":[{"title":"Mail","href":"/mail-guide/introduction"}]},{"tab":"Outbound","icon":"phone","pages":[{"title":"Outbound","href":"/outbound-guide/introduction"}]},{"tab":"Sync","icon":"arrows-rotate","pages":[{"title":"Sync","href":"/sync-guide/introduction"}]}]},"basePath":"","title":"Mail tenant credentials - Help Genie","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":[],"chunks":[]}