Provisions a new inbox. The server creates the backing inbox on a verified custom domain, registers the account for warmup, creates/assigns the account tag, and inserts the row into the accounts table with type = "email".Warmup analytics live behind a separate endpoint — GET /api/email/accounts/warmup-analytics — and are not returned here.
This operation shares the URL path /api/email/accounts with the list verb. See List inboxes to enumerate existing inboxes.
AI agent notes
Prerequisite: a verified domain.createEmailAccount rejects any domain_id whose backing email_domains.status is not verified. The usual flow is:
createEmailDomain — register the domain, DNS auto-synced when Pixie can manage the zone.
Poll verifyEmailDomain with ?poll=true on a cadence until status === "verified" (or status === "failed").
Only then call createEmailAccount with that domain_id.
Side effects on create. Several external operations run in sequence: backing inbox creation, warmup registration, tag creation/assignment, and the final Supabase insert. If any step after inbox creation fails, the backing inbox is cleaned up when possible. Some backing providers block reusing the local part of a previously-deleted inbox — callers will see a 409 if they try.Warmup blocks sending. Accounts with status: "warming" will NOT send campaign emails until warmup completes (or is disabled). Plan for a warmup window before scheduling the first real campaign.
Authorizations
Authorization
string
header
required
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
Required: username + domain_id. The full address is composed as <username>@<domain>. Provisioning creates the backing inbox, registers warmup, creates or assigns tags, and inserts the DB row; partial failures trigger best-effort rollback.
username
string
required
Local part of the email (everything before @). Lowercased server-side. Only a-z, 0-9, ., -, _ are allowed.
Minimum string length: 1
domain_id
string<uuid>
required
UUID of an email_domains row owned by the caller. The domain's status must be verified — see POST /api/email/domains/{id}/verify.
display_name
string
Human-friendly sender name. If omitted and first_name/last_name are set, display_name is derived from them.
first_name
string
last_name
string
Response
Account created. If warmup enablement succeeded, status is warming and warmup_status is warming. If warmup failed, status is pending and the client can retry via retry-account-warmup.
account
object
required
A Pixie-managed email sending inbox. Each account row maps to one backing inbox and optional warmup registration.
Show child attributes
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Pixie Docs","description":"GTM intelligence platform for founders","colors":{"primary":"#00308F","light":"#4169E1","dark":"#001F5C"},"logo":{"light":"https://mintcdn.com/puffle-a7721060/DUkYTzv9fN1jgWMK/logo-light.svg?fit=max\u0026auto=format\u0026n=DUkYTzv9fN1jgWMK\u0026q=85\u0026s=6f6ed3122fe70c6655b8e0f15a633429","dark":"https://mintcdn.com/puffle-a7721060/DUkYTzv9fN1jgWMK/logo-dark.svg?fit=max\u0026auto=format\u0026n=DUkYTzv9fN1jgWMK\u0026q=85\u0026s=6e0cea776235f47330d3f503b89d3014"},"favicon":"https://mintcdn.com/puffle-a7721060/DUkYTzv9fN1jgWMK/favicon.svg?fit=max\u0026auto=format\u0026n=DUkYTzv9fN1jgWMK\u0026q=85\u0026s=4f98900fd6bf3ca38403f68e7aef9f09","api":{"openapi":"api-reference/openapi.json","params":{"post":["x-param-pill"]}},"background":{"color":{"light":"#FFFFFF","dark":"#000000"}},"interaction":{"drilldown":false},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"puffle-a7721060","hasAudioNarration":false,"actualSubdomain":"puffle-a7721060","customDomains":["docs.pixiegtm.com"],"gitSource":{"type":"github","owner":"developiq-ai","repo":"pixie-app","deployBranch":"main","contentDirectory":"mintlify","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6adf4cb1f325da4ba4e0ec9b","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"default","tag":"API Reference","count":71},{"language":"default","tag":"Endpoints","count":71},{"language":"default","tag":"Lead Finder","count":12},{"language":"default","tag":"Outbound","count":11},{"language":"default","tag":"Unibox","count":7},{"language":"default","tag":"Accounts","count":6},{"language":"default","tag":"Email Inboxes","count":6},{"language":"default","tag":"Sending Domains","count":6},{"language":"default","tag":"Documentation","count":6},{"language":"default","tag":"Outbound Contacts","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":".pixie-welcome-callout{display:flex;gap:16px;align-items:flex-start;margin:32px 0 24px;padding:18px 20px;border:1px solid #7dd3a8;border-radius:10px;background:#f1fbf5;color:#047857}.pixie-welcome-callout-icon{flex:none;color:#059669;font-size:20px;line-height:1.3}.pixie-welcome-callout-title{display:block;margin:0 0 12px;color:#047857;font-weight:700}.pixie-welcome-callout-copy{display:block;color:#047857}html.dark .pixie-welcome-callout{border-color:#047857;background:#001f12;color:#34d399}html.dark .pixie-welcome-callout-icon,html.dark .pixie-welcome-callout-title,html.dark .pixie-welcome-callout-copy{color:#34d399!important}"}],"page":{"pagePath":"api-reference/senders/create-email-account","slug":"/api-reference/senders/create-email-account","pageMetadata":{"title":"Create Inbox","description":"Provision a new Pixie-managed inbox on a verified custom domain and register it for warmup.","openapi":"post /api/email/accounts","href":"/api-reference/senders/create-email-account"},"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: \"Provision a new Pixie-managed inbox on a verified custom domain and register it for warmup.\"\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={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,..._provideComponents(),...props.components},{CodeBlock,Heading,Note}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:_jsx(_components.strong,{children:`CLI:`})}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`pixie`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` email`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` account`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` create`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --username`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`usernam`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`e`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --domain-id`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`domain-i`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`d`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`pixie`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` email`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` account`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` create`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --username`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`usernam`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`e`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --domain-id`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`domain-i`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`d`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --display-name`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`display-nam`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`e`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --first-name`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`first-nam`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`e`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --last-name`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`last-nam`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`e`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`overview`,children:`Overview`}),`\n`,_jsxs(_components.p,{children:[`Provisions a new inbox. The server creates the backing inbox on a verified custom domain, registers the account for warmup, creates/assigns the account tag, and inserts the row into the `,_jsx(_components.code,{children:`accounts`}),` table with `,_jsx(_components.code,{children:`type = \"email\"`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`Warmup analytics live behind a separate endpoint — `,_jsx(_components.code,{children:`GET /api/email/accounts/warmup-analytics`}),` — and are not returned here.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`This operation shares the URL path `,_jsx(_components.code,{children:`/api/email/accounts`}),` with the list verb. See `,_jsx(_components.a,{href:`/api-reference/senders/list-email-accounts`,children:`List inboxes`}),` to enumerate existing inboxes.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`ai-agent-notes`,children:`AI agent notes`}),`\n`,_jsxs(Note,{children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Prerequisite: a verified domain.`}),` `,_jsx(_components.code,{children:`createEmailAccount`}),` rejects any `,_jsx(_components.code,{children:`domain_id`}),` whose backing `,_jsx(_components.code,{children:`email_domains.status`}),` is not `,_jsx(_components.code,{children:`verified`}),`. The usual flow is:`]}),_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`createEmailDomain`}),` — register the domain, DNS auto-synced when Pixie can manage the zone.`]}),`\n`,_jsxs(_components.li,{children:[`Poll `,_jsx(_components.code,{children:`verifyEmailDomain`}),` with `,_jsx(_components.code,{children:`?poll=true`}),` on a cadence until `,_jsx(_components.code,{children:`status === \"verified\"`}),` (or `,_jsx(_components.code,{children:`status === \"failed\"`}),`).`]}),`\n`,_jsxs(_components.li,{children:[`Only then call `,_jsx(_components.code,{children:`createEmailAccount`}),` with that `,_jsx(_components.code,{children:`domain_id`}),`.`]}),`\n`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Side effects on create.`}),` Several external operations run in sequence: backing inbox creation, warmup registration, tag creation/assignment, and the final Supabase insert. If any step after inbox creation fails, the backing inbox is cleaned up when possible. Some backing providers block reusing the local part of a previously-deleted inbox — callers will see a 409 if they try.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Warmup blocks sending.`}),` Accounts with `,_jsx(_components.code,{children:`status: \"warming\"`}),` will NOT send campaign emails until warmup completes (or is disabled). Plan for a warmup window before scheduling the first real campaign.`]})]})]})}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":"Create Inbox","description":"Provision a new Pixie-managed inbox on a verified custom domain and register it for warmup.","openapi":"post /api/email/accounts","href":"/api-reference/senders/create-email-account"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Overview","slug":"overview","depth":2,"children":[]},{"title":"AI agent notes","slug":"ai-agent-notes","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/puffle-a7721060/c08f9ef5836940ef/ai-agent-notes-bottom.js"],"openApiReferenceData":{"operation":{"operationId":"createEmailAccount","summary":"Create Inbox","description":"Provision a new Pixie-managed inbox on a verified custom domain and register it for warmup.","tags":["Senders"],"parameters":[],"requestBody":"f1df5214-2f16-4071-b88b-6b33109b8cde","responses":{"201":"cb20c86d-42d0-439b-b6c3-e3aced305f6e","400":"ab15bd41-42af-43f0-a7b0-b297dd118d91","401":"803dd8bd-9b7b-4a15-9b7d-3611b64d388d","402":"e2c6c754-3578-4e53-897e-7d1d860b023a","404":"e0108a3a-872c-4ade-86e9-df76c53aeb0f","409":"4120f314-ee60-4c76-b1de-a62821854eb4","500":"edbfba0b-aefb-4d0c-83e2-c3344c6f8c72"},"x-pixie-cli":{"command":"pixie email account create","auth":"apiKey","flags":[{"name":"username","from":"body.username","type":"string","required":true,"description":"Local part of the email (everything before `@`). Lowercased server-side. Only `a-z`, `0-9`, `.`, `-`, `_` are allowed."},{"name":"domain-id","from":"body.domain_id","type":"string","required":true,"description":"UUID of an `email_domains` row owned by the caller. The domain's `status` must be `verified` — see `POST /api/email/domains/{id}/verify`."},{"name":"display-name","from":"body.display_name","type":"string","required":false,"description":"Human-friendly sender name. If omitted and `first_name`/`last_name` are set, `display_name` is derived from them."},{"name":"first-name","from":"body.first_name","type":"string","required":false},{"name":"last-name","from":"body.last_name","type":"string","required":false}]},"method":"post","type":"path","servers":["3f705fd1-36b3-48c2-9ff5-0b216d4c8835"],"security":["389a9986-625f-46f1-8c08-80e2d40d3784"],"path":"/api/email/accounts","baseUrlOptions":["https://app.pixiegtm.com"],"title":"Create Inbox","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string","minLength":1,"description":"Local part of the email (everything before `@`). Lowercased server-side. Only `a-z`, `0-9`, `.`, `-`, `_` are allowed.","isRequired":true,"uniqueKey":"username","typeLabel":"string"},"domain_id":{"type":"string","format":"uuid","description":"UUID of an `email_domains` row owned by the caller. The domain's `status` must be `verified` — see `POST /api/email/domains/{id}/verify`.","isRequired":true,"uniqueKey":"domain_id","typeLabel":"string\u003cuuid>"},"display_name":{"description":"Human-friendly sender name. If omitted and `first_name`/`last_name` are set, `display_name` is derived from them.","type":"string","uniqueKey":"display_name","typeLabel":"string"},"first_name":{"type":"string","uniqueKey":"first_name","typeLabel":"string"},"last_name":{"type":"string","uniqueKey":"last_name","typeLabel":"string"}},"required":["username","domain_id"],"additionalProperties":false,"description":"Required: `username` + `domain_id`. The full address is composed as `\u003cusername>@\u003cdomain>`. Provisioning creates the backing inbox, registers warmup, creates or assigns tags, and inserts the DB row; partial failures trigger best-effort rollback.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"username":"\u003cstring>","domain_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","display_name":"\u003cstring>","first_name":"\u003cstring>","last_name":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"cb20c86d-42d0-439b-b6c3-e3aced305f6e":{"description":"Account created. If warmup enablement succeeded, `status` is `warming` and `warmup_status` is `warming`. If warmup failed, `status` is `pending` and the client can retry via `retry-account-warmup`.","content":{"application/json":{"schema":{"type":"object","properties":{"account":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Primary key in the `accounts` table.","isRequired":true,"uniqueKey":"account.id","typeLabel":"string\u003cuuid>"},"user_id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"account.user_id","typeLabel":"string\u003cuuid>"},"type":{"type":"string","enum":["email"],"isRequired":true,"uniqueKey":"account.type","typeLabel":"enum\u003cstring>"},"domain_id":{"oneOf":[{"description":"FK to `email_domains.id` — the custom sending domain.","type":"string","format":"uuid","isRequired":true,"uniqueKey":"account.domain_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"description":"FK to `email_domains.id` — the custom sending domain.","type":"null","format":"uuid","isRequired":true,"uniqueKey":"account.domain_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"account.domain_id","typeLabel":"string\u003cuuid> | null"},"email_address":{"oneOf":[{"description":"Full inbox address, e.g. `[email protected]`. Derived from `\u003cusername>@\u003cdomain>` at creation.","type":"string","format":"email","isRequired":true,"uniqueKey":"account.email_address.oneOf.0","typeLabel":"string\u003cemail>"},{"description":"Full inbox address, e.g. `[email protected]`. Derived from `\u003cusername>@\u003cdomain>` at creation.","type":"null","format":"email","isRequired":true,"uniqueKey":"account.email_address.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"account.email_address","typeLabel":"string\u003cemail> | null"},"agentmail_inbox_id":{"oneOf":[{"description":"Backing inbox identifier. Used internally for send/reply routing and inbound webhook dedupe.","type":"string","isRequired":true,"uniqueKey":"account.agentmail_inbox_id.oneOf.0","typeLabel":"string"},{"description":"Backing inbox identifier. Used internally for send/reply routing and inbound webhook dedupe.","type":"null","isRequired":true,"uniqueKey":"account.agentmail_inbox_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"account.agentmail_inbox_id","typeLabel":"string | null"},"instantly_account_id":{"oneOf":[{"description":"Warmup account identifier. Present while the account is registered for warmup analytics; legacy field.","type":"string","isRequired":true,"uniqueKey":"account.instantly_account_id.oneOf.0","typeLabel":"string"},{"description":"Warmup account identifier. Present while the account is registered for warmup analytics; legacy field.","type":"null","isRequired":true,"uniqueKey":"account.instantly_account_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"account.instantly_account_id","typeLabel":"string | null"},"status":{"type":"string","enum":["pending","warming","active","disconnected"],"description":"Account readiness. Newly-created inboxes are `warming` (warmup running) or `pending` (warmup failed at creation). `active` accounts can send campaign emails.","isRequired":true,"uniqueKey":"account.status","typeLabel":"enum\u003cstring>"},"warmup_status":{"oneOf":[{"description":"Warmup lifecycle. Campaigns will NOT send from accounts with `warming` status unless an admin override is enabled.","type":"string","enum":["not_started","warming","completed","disabled"],"isRequired":true,"uniqueKey":"account.warmup_status.oneOf.0","typeLabel":"enum\u003cstring>"},{"description":"Warmup lifecycle. Campaigns will NOT send from accounts with `warming` status unless an admin override is enabled.","type":"null","enum":["not_started","warming","completed","disabled"],"isRequired":true,"uniqueKey":"account.warmup_status.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"account.warmup_status","typeLabel":"enum\u003cstring> | null"},"is_default_sender":{"type":"boolean","description":"Whether this inbox is the user's default email sender. New accounts get one default warmed sender during onboarding.","isRequired":true,"uniqueKey":"account.is_default_sender","typeLabel":"boolean"},"display_name":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"account.display_name.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"account.display_name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"account.display_name","typeLabel":"string | null"},"first_name":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"account.first_name.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"account.first_name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"account.first_name","typeLabel":"string | null"},"last_name":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"account.last_name.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"account.last_name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"account.last_name","typeLabel":"string | null"},"signature":{"oneOf":[{"description":"Per-account email signature. Synced before PATCH completes; newlines become `\u003cbr>` for HTML rendering.","type":"string","isRequired":true,"uniqueKey":"account.signature.oneOf.0","typeLabel":"string"},{"description":"Per-account email signature. Synced before PATCH completes; newlines become `\u003cbr>` for HTML rendering.","type":"null","isRequired":true,"uniqueKey":"account.signature.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"account.signature","typeLabel":"string | null"},"instantly_tag_id":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"account.instantly_tag_id.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"account.instantly_tag_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"account.instantly_tag_id","typeLabel":"string | null"},"instantly_warmup_tag_id":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"account.instantly_warmup_tag_id.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"account.instantly_warmup_tag_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"account.instantly_warmup_tag_id","typeLabel":"string | null"},"created_at":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"account.created_at","typeLabel":"string\u003cdate-time>"},"updated_at":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"account.updated_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"account.updated_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"account.updated_at","typeLabel":"string\u003cdate-time> | null"},"email_domains":{"oneOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"account.email_domains.oneOf.0.id","typeLabel":"string\u003cuuid>"},"domain":{"type":"string","isRequired":true,"uniqueKey":"account.email_domains.oneOf.0.domain","typeLabel":"string"},"status":{"type":"string","enum":["pending","verifying","verified","failed"],"description":"Lifecycle status of the backing custom domain. Only `verified` domains can be used to create new inboxes.","isRequired":true,"uniqueKey":"account.email_domains.oneOf.0.status","typeLabel":"enum\u003cstring>"}},"required":["id","domain","status"],"additionalProperties":false,"description":"Compact domain reference joined onto each account row so clients can show which custom sending domain an inbox belongs to without a second round-trip.","isRequired":true,"uniqueKey":"account.email_domains.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"id":{"type":"string","format":"uuid"},"domain":{"type":"string"},"status":{"type":"string","enum":["pending","verifying","verified","failed"],"description":"Lifecycle status of the backing custom domain. Only `verified` domains can be used to create new inboxes."}},"required":["id","domain","status"],"additionalProperties":false,"description":"Compact domain reference joined onto each account row so clients can show which custom sending domain an inbox belongs to without a second round-trip.","isRequired":true,"uniqueKey":"account.email_domains.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"account.email_domains","typeLabel":"object | null"}},"required":["id","user_id","type","domain_id","email_address","agentmail_inbox_id","instantly_account_id","status","warmup_status","is_default_sender","display_name","first_name","last_name","signature","instantly_tag_id","instantly_warmup_tag_id","created_at","updated_at","email_domains"],"additionalProperties":false,"description":"A Pixie-managed email sending inbox. Each account row maps to one backing inbox and optional warmup registration.","isRequired":true,"uniqueKey":"account","typeLabel":"object"}},"required":["account"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"account":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","user_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","type":"email","domain_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","email_address":"[email protected]","agentmail_inbox_id":"\u003cstring>","instantly_account_id":"\u003cstring>","status":"pending","warmup_status":"not_started","is_default_sender":true,"display_name":"\u003cstring>","first_name":"\u003cstring>","last_name":"\u003cstring>","signature":"\u003cstring>","instantly_tag_id":"\u003cstring>","instantly_warmup_tag_id":"\u003cstring>","created_at":"2023-11-07T05:31:56Z","updated_at":"2023-11-07T05:31:56Z","email_domains":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","domain":"\u003cstring>","status":"pending"}}}}},"exampleType":"generated"}},"exampleType":"generated"},"ab15bd41-42af-43f0-a7b0-b297dd118d91":{"description":"Validation failure or the backing domain is not verified. Common causes: missing `username`/`domain_id`, invalid username characters, or the verification service reports the domain as unverified (DB auto-corrected to `pending`).","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"required":["error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"803dd8bd-9b7b-4a15-9b7d-3611b64d388d":{"description":"Missing or invalid Bearer token.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"required":["error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"e2c6c754-3578-4e53-897e-7d1d860b023a":{"description":"Warmup cannot be registered because the backing warmup workspace is not enabled. The inbox is rolled back.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"required":["error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"e0108a3a-872c-4ade-86e9-df76c53aeb0f":{"description":"`domain_id` does not point at a domain owned by the caller.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"required":["error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"4120f314-ee60-4c76-b1de-a62821854eb4":{"description":"An account with this email already exists, this domain already has five inboxes, or the backing inbox service rejects reuse of a previously-deleted local part.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"required":["error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"edbfba0b-aefb-4d0c-83e2-c3344c6f8c72":{"description":"A provisioning step failed. Common causes: backing inbox creation, warmup registration, or the final DB insert (with best-effort rollback of the backing inbox).","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"required":["error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"389a9986-625f-46f1-8c08-80e2d40d3784":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"pk_live_...","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"3f705fd1-36b3-48c2-9ff5-0b216d4c8835":{"url":"https://app.pixiegtm.com","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"pk_live_...","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"puffle-a7721060","siteName":"Pixie Docs","title":"Create Inbox - Pixie Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-25T08:33:02.439Z","originalFileLocation":"api-reference/senders/create-email-account.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=\"Provision a new Pixie-managed inbox on a verified custom domain and register it for warmup.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Pixie Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/puffle-a7721060/KPLMc4mzEDC3MpCF/_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/puffle-a7721060/KPLMc4mzEDC3MpCF/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/puffle-a7721060/KPLMc4mzEDC3MpCF/_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/puffle-a7721060/KPLMc4mzEDC3MpCF/_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/puffle-a7721060/KPLMc4mzEDC3MpCF/_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/puffle-a7721060/KPLMc4mzEDC3MpCF/_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/puffle-a7721060/KPLMc4mzEDC3MpCF/_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/puffle-a7721060/KPLMc4mzEDC3MpCF/_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/puffle-a7721060/KPLMc4mzEDC3MpCF/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create Inbox - Pixie Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Provision a new Pixie-managed inbox on a verified custom domain and register it for warmup.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Pixie Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.pixiegtm.com/api-reference/senders/create-email-account\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://puffle-a7721060.mintlify.site/_mintlify/api/og/v2?division=Email+Inboxes\u0026amp;title=Create+Inbox\u0026amp;description=Provision+a+new+Pixie-managed+inbox+on+a+verified+custom+domain+and+register+it+for+warmup.\u0026amp;theme=28e6c6df0ec34bca1003614e\u0026amp;signature=0abd75eb8ec0151adb265efb17af185c7057337b2a430a846f0cad43d6f9bddf\">\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 Inbox - Pixie Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Provision a new Pixie-managed inbox on a verified custom domain and register it for warmup.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://puffle-a7721060.mintlify.site/_mintlify/api/og/v2?division=Email+Inboxes\u0026amp;title=Create+Inbox\u0026amp;description=Provision+a+new+Pixie-managed+inbox+on+a+verified+custom+domain+and+register+it+for+warmup.\u0026amp;theme=28e6c6df0ec34bca1003614e\u0026amp;signature=0abd75eb8ec0151adb265efb17af185c7057337b2a430a846f0cad43d6f9bddf\">\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/puffle-a7721060/KPLMc4mzEDC3MpCF/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Pixie Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#00308F\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.pixiegtm.com/api-reference/senders/create-email-account\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/senders/create-email-account.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.pixiegtm.com/#organization\",\"name\":\"Pixie Docs\",\"url\":\"https://docs.pixiegtm.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/puffle-a7721060/DUkYTzv9fN1jgWMK/logo-light.svg?fit=max\u0026auto=format\u0026n=DUkYTzv9fN1jgWMK\u0026q=85\u0026s=6f6ed3122fe70c6655b8e0f15a633429\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.pixiegtm.com#website\",\"name\":\"Pixie Docs\",\"url\":\"https://docs.pixiegtm.com\",\"publisher\":{\"@id\":\"https://docs.pixiegtm.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.pixiegtm.com/api-reference/senders/create-email-account#webpage\",\"url\":\"https://docs.pixiegtm.com/api-reference/senders/create-email-account\",\"name\":\"Create Inbox\",\"description\":\"Provision a new Pixie-managed inbox on a verified custom domain and register it for warmup.\",\"dateModified\":\"2026-08-25T08:33:02.439Z\",\"isPartOf\":{\"@id\":\"https://docs.pixiegtm.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.pixiegtm.com/api-reference/senders/create-email-account#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.pixiegtm.com/api-reference/senders/create-email-account#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://docs.pixiegtm.com/api-reference/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Email Inboxes\",\"item\":\"https://docs.pixiegtm.com/api-reference/senders/list-email-accounts\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Create Inbox\",\"item\":\"https://docs.pixiegtm.com/api-reference/senders/create-email-account\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.pixiegtm.com/api-reference/senders/create-email-account#apireference\",\"headline\":\"Create Inbox\",\"name\":\"Create Inbox\",\"description\":\"Provision a new Pixie-managed inbox on a verified custom domain and register it for warmup.\",\"url\":\"https://docs.pixiegtm.com/api-reference/senders/create-email-account\",\"mainEntityOfPage\":{\"@id\":\"https://docs.pixiegtm.com/api-reference/senders/create-email-account#webpage\"},\"dateModified\":\"2026-08-25T08:33:02.439Z\",\"publisher\":{\"@id\":\"https://docs.pixiegtm.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.pixiegtm.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Pixie Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Pixie Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/senders/create-email-account.md","siteName":"Pixie Docs","nav":{"global":null,"tabs":[{"tab":"Documentation","icon":"book-open","pages":[{"title":"Documentation","href":"/welcome"}]},{"tab":"API Reference","icon":"terminal","groups":[{"group":"Endpoints","pages":[{"title":"API Overview","href":"/api-reference/overview"},{"title":"API Keys","href":"/api-reference/api-keys/overview"},{"group":"Lead Finder","pages":[{"title":"List Lead Finder searches and latest run status","openapi":"get /api/lead-finder","href":"/api-reference/lead-finder/lead-finder.list"},{"title":"Create a Lead Finder search and start its first run","openapi":"post /api/lead-finder","href":"/api-reference/lead-finder/lead-finder.create"},{"title":"Get one Lead Finder search and paginated results","openapi":"get /api/lead-finder/{id}","href":"/api-reference/lead-finder/lead-finder.get"},{"title":"Update one Lead Finder search","openapi":"patch /api/lead-finder/{id}","href":"/api-reference/lead-finder/lead-finder.update"},{"title":"Resolve an exact Lead Finder title without selecting between duplicates","openapi":"get /api/lead-finder/resolve","href":"/api-reference/lead-finder/lead-finder.resolve"},{"title":"List sources available for new Lead Finder searches","openapi":"get /api/lead-finder/sources","href":"/api-reference/lead-finder/lead-finder.sources"},{"title":"Query reviewed Lead Finder enrichment values","openapi":"post /api/lead-finder/{id}/results/query","href":"/api-reference/lead-finder/lead-finder.query-results"},{"title":"Get one reviewed Lead Finder enrichment profile","openapi":"get /api/lead-finder/{id}/results/{resultId}/enrichment","href":"/api-reference/lead-finder/lead-finder.get-result-enrichment"},{"title":"List reviewed Lead Finder enrichment fields","openapi":"get /api/lead-finder/{id}/enrichment-fields","href":"/api-reference/lead-finder/lead-finder.enrichment-fields"},{"title":"Run every eligible Lead Finder search","openapi":"post /api/lead-finder/run","href":"/api-reference/lead-finder/lead-finder.run-all"},{"title":"Run one Lead Finder search","openapi":"post /api/lead-finder/{id}/run","href":"/api-reference/lead-finder/lead-finder.run-one"},{"title":"Stop the active run for one Lead Finder search without changing its future schedule","openapi":"post /api/lead-finder/{id}/stop","href":"/api-reference/lead-finder/lead-finder.stop-one"}]},{"group":"Outbound","pages":[{"title":"List Outbound","openapi":"get /api/campaigns","href":"/api-reference/campaigns/list-campaigns"},{"title":"Get Outbound","openapi":"get /api/campaigns/{id}","href":"/api-reference/campaigns/get-campaign"},{"title":"Create Draft Outbound","openapi":"post /api/campaigns","href":"/api-reference/campaigns/create-draft-campaign"},{"title":"Update Outbound","openapi":"patch /api/campaigns/{id}","href":"/api-reference/campaigns/update-campaign"},{"title":"Delete Campaign","openapi":"delete /api/campaigns/{id}","href":"/api-reference/campaigns/delete-campaign"},{"title":"Launch Outbound","openapi":"post /api/campaigns/{id}/launch","href":"/api-reference/campaigns/launch-campaign"},{"title":"Pause Campaign","openapi":"post /api/campaigns/{id}/pause","href":"/api-reference/campaigns/pause-campaign"},{"title":"Resume Campaign","openapi":"post /api/campaigns/{id}/resume","href":"/api-reference/campaigns/resume-campaign"},{"title":"List outbound sender mapping","openapi":"get /api/campaigns/mapping","href":"/api-reference/campaigns/list-outbound-sender-mapping"},{"title":"Get durable campaign message metrics","openapi":"get /api/campaigns/{id}/message-metrics","href":"/api-reference/campaigns/get-campaign-message-metrics"},{"title":"Get Senders for Campaign","openapi":"get /api/campaigns/{id}/senders","href":"/api-reference/campaigns/get-senders-for-campaign"}]},{"group":"Outbound Contacts","pages":[{"title":"Get Leads in Campaign","openapi":"get /api/campaigns/{id}/leads","href":"/api-reference/campaigns/get-leads-in-campaign"},{"title":"Add Leads to Campaign","openapi":"post /api/campaigns/{id}/leads","href":"/api-reference/campaigns/add-leads-to-campaign"},{"title":"Update Lead in Campaign","openapi":"patch /api/campaigns/{id}/leads","href":"/api-reference/campaigns/update-lead-in-campaign"},{"title":"Remove Leads from Campaign","openapi":"delete /api/campaigns/{id}/leads","href":"/api-reference/campaigns/remove-leads-from-campaign"},{"title":"Import Leads from List to Campaign","openapi":"post /api/campaigns/{id}/leads/import-from-list","href":"/api-reference/campaigns/import-leads-from-list-to-campaign"}]},{"group":"Outbound Sequence","pages":[{"title":"Add Node","openapi":"post /api/campaigns/{id}/sequence/nodes","href":"/api-reference/campaigns/add-sequence-node"},{"title":"Update Node","openapi":"put /api/campaigns/{id}/sequence/nodes/{nodeId}","href":"/api-reference/campaigns/update-sequence-node"},{"title":"Reorder Node","openapi":"patch /api/campaigns/{id}/sequence/nodes","href":"/api-reference/campaigns/move-sequence-node"},{"title":"Delete Node","openapi":"delete /api/campaigns/{id}/sequence/nodes","href":"/api-reference/campaigns/delete-sequence-node"}]},{"group":"Outbound Messages","pages":[{"title":"List Generated Messages","openapi":"get /api/campaigns/{id}/generate-messages","href":"/api-reference/campaigns/list-campaign-generated-messages"},{"title":"Generate Messages","openapi":"post /api/campaigns/{id}/generate-messages","href":"/api-reference/campaigns/generate-campaign-messages"},{"title":"Edit Generated Message","openapi":"patch /api/campaigns/{id}/generate-messages","href":"/api-reference/campaigns/update-campaign-generated-message"}]},{"group":"Outbound Settings","pages":[{"title":"Get Campaign Settings","openapi":"get /api/campaigns/settings","href":"/api-reference/campaigns/get-campaign-settings"},{"title":"Update Campaign Settings","openapi":"put /api/campaigns/settings","href":"/api-reference/campaigns/update-campaign-settings"}]},{"group":"Unibox","pages":[{"title":"Get Threads","openapi":"get /api/threads","href":"/api-reference/unibox/list-threads"},{"title":"Create Thread","openapi":"post /api/threads","href":"/api-reference/unibox/create-thread"},{"title":"Get Thread","openapi":"get /api/threads/{id}","href":"/api-reference/unibox/get-thread"},{"title":"Update Thread","openapi":"patch /api/threads/{id}","href":"/api-reference/unibox/update-thread"},{"title":"Delete Draft Thread","openapi":"delete /api/threads/{id}","href":"/api-reference/unibox/discard-draft-thread"},{"title":"Get Messages","openapi":"get /api/threads/{id}/messages","href":"/api-reference/unibox/list-thread-messages"},{"title":"Send Message","openapi":"post /api/threads/{id}/messages","href":"/api-reference/unibox/send-thread-message"}]},{"group":"Senders","pages":[{"title":"List Senders","openapi":"get /api/senders","href":"/api-reference/senders/list-senders"},{"title":"Get Sender Details","openapi":"get /api/senders/{id}","href":"/api-reference/senders/get-sender-details"},{"title":"Get Sender Schedule","openapi":"get /api/senders/{id}/schedule","href":"/api-reference/senders/get-account-schedule"}]},{"group":"Email Inboxes","pages":[{"title":"List Inboxes","description":"Return every inbox owned by the caller, newest first.","openapi":"get /api/email/accounts","href":"/api-reference/senders/list-email-accounts"},{"title":"Create Inbox","openapi":"post /api/email/accounts","href":"/api-reference/senders/create-email-account"},{"title":"Update Inbox","description":"Update mutable fields on an inbox.","openapi":"patch /api/email/accounts/{id}","href":"/api-reference/senders/update-email-account"},{"title":"Retry Inbox Warmup","openapi":"patch /api/email/accounts/{id}/retry-warmup","href":"/api-reference/senders/retry-account-warmup"},{"title":"Get Warmup Analytics","openapi":"get /api/email/accounts/warmup-analytics","href":"/api-reference/senders/get-warmup-analytics"},{"title":"Delete Inbox","openapi":"delete /api/email/accounts/{id}","href":"/api-reference/senders/delete-email-account"}]},{"group":"Sending Domains","pages":[{"title":"List Sending Domains","openapi":"get /api/email/domains","href":"/api-reference/senders/list-email-domains"},{"title":"Create Sending Domain","openapi":"post /api/email/domains","href":"/api-reference/senders/create-email-domain"},{"title":"Verify Domain","openapi":"post /api/email/domains/{id}/verify","href":"/api-reference/senders/verify-email-domain"},{"title":"DNS Records","openapi":"get /api/email/domains/{id}/dns-records","href":"/api-reference/senders/get-email-domain-dns-records"},{"title":"Update Domain Status","openapi":"patch /api/email/domains/{id}","href":"/api-reference/senders/update-email-domain"},{"title":"Delete Sending Domain","openapi":"delete /api/email/domains/{id}","href":"/api-reference/senders/delete-email-domain"}]},{"group":"Accounts","pages":[{"title":"Get Profile","openapi":"get /api/account","href":"/api-reference/accounts/get-account"},{"title":"Update Profile","openapi":"patch /api/account","href":"/api-reference/accounts/update-account"},{"title":"Get Company Profile","openapi":"get /api/context","href":"/api-reference/accounts/list-context"},{"title":"Update Company Profile","openapi":"put /api/context","href":"/api-reference/accounts/update-context"},{"title":"Approve onboarding section","openapi":"post /api/onboarding/approve-section","href":"/api-reference/accounts/approve-onboarding-section"},{"title":"Complete onboarding","openapi":"post /api/onboarding/complete","href":"/api-reference/accounts/complete-onboarding"}]},{"group":"Billing","pages":[{"title":"Start hosted billing checkout","openapi":"post /api/billing/checkout","href":"/api-reference/billing/billing.checkout"}]},{"group":"Discovery Pass","pages":[{"title":"Activate eligible Discovery Pass","openapi":"post /api/test-access/auto-grant","href":"/api-reference/discovery-pass/test-access.auto-grant"},{"title":"Get Discovery Pass status","openapi":"get /api/test-access","href":"/api-reference/discovery-pass/test-access.get"},{"title":"Redeem Discovery Pass code","openapi":"post /api/test-access/redeem","href":"/api-reference/discovery-pass/test-access.redeem"}]}]}]},{"tab":"Guides","icon":"book","pages":[{"title":"Guides","href":"/guides/agent-playbook"}]}]},"basePath":"","title":"Create Inbox - Pixie Docs","buildId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","deploymentId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DdEMm2kG.js","utils-BMo572L7.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C-4m9KAx.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DPLK2Oq9.js","snippetPresets-BKjfJMC9.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-DTsgtCEj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C8vmhyQM.js","shallow-r9w8LQGS.js","getApiPlaygroundDisplay-DjPI64HQ.js","CodeSnippet-C8Bvhl16.js","CodeSnippets-BtWUwcMy.js","Page-BIYvYBgk.js","getPastedJson-Dcm_3Pgl.js","icon-BXwrTpjc.js","MethodPill-CcjfVmmy.js","DuplicateIcon-BuKIbXAQ.js","createIcon-DaL9yXsO.js","DynamicMarkdown-Co5nikxh.js","SectionHeading-P4UNTsMZ.js","axios-vUo_bRtp.js","Markdown-CEfymfIH.js","clsx-Dq9TQuNi.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-D2J8knkn.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BgZ2ThuU.js"]}