{ "status": "error", "code": "INVALID_MAILBOX", "message": "Mailbox jane..doe is not a valid email local part"}
{ "message": "Invalid API Key"}
{ "status": "error", "code": "DOMAIN_NOT_FOUND", "message": "We couldn't find example.com on order SS-1712345678901-4242-1 on your account. Check the domain name and the id of the order it was bought under."}
{ "status": "error", "code": "MAILBOX_LIMIT_EXCEEDED", "message": "A domain can have at most 5 mailboxes. example.com already has 4, so only 1 more can be added; 2 requested"}
{ "status": "error", "code": "DOMAIN_FULL_PENDING_DELETION", "message": "Domain example.com has no free mailbox slots because 1 mailbox is pending deletion. Permanently delete one to free a slot.", "pending_mailboxes": [ { "id": 987654, "from_email": "old@example.com", "scheduled_delete_at": "2026-11-02T00:00:00.000Z" } ]}
{ "status": "error", "code": "ADD_MAILBOXES_IN_PROGRESS", "message": "Mailboxes are already being added to this domain. Wait for that request to finish before retrying."}
{ "status": "error", "code": "ADD_MAILBOXES_STATUS_UNKNOWN", "message": "We couldn't confirm whether these mailboxes were added. To avoid being billed twice, check order SS-1712345678901-4242-1 in a few minutes before retrying."}
Smart Senders
Add Mailboxes to Domain
Add mailboxes to a domain you already bought through Smart Senders, billed on the domain’s existing mailbox subscription
{ "status": "error", "code": "INVALID_MAILBOX", "message": "Mailbox jane..doe is not a valid email local part"}
{ "message": "Invalid API Key"}
{ "status": "error", "code": "DOMAIN_NOT_FOUND", "message": "We couldn't find example.com on order SS-1712345678901-4242-1 on your account. Check the domain name and the id of the order it was bought under."}
{ "status": "error", "code": "MAILBOX_LIMIT_EXCEEDED", "message": "A domain can have at most 5 mailboxes. example.com already has 4, so only 1 more can be added; 2 requested"}
{ "status": "error", "code": "DOMAIN_FULL_PENDING_DELETION", "message": "Domain example.com has no free mailbox slots because 1 mailbox is pending deletion. Permanently delete one to free a slot.", "pending_mailboxes": [ { "id": 987654, "from_email": "old@example.com", "scheduled_delete_at": "2026-11-02T00:00:00.000Z" } ]}
{ "status": "error", "code": "ADD_MAILBOXES_IN_PROGRESS", "message": "Mailboxes are already being added to this domain. Wait for that request to finish before retrying."}
{ "status": "error", "code": "ADD_MAILBOXES_STATUS_UNKNOWN", "message": "We couldn't confirm whether these mailboxes were added. To avoid being billed twice, check order SS-1712345678901-4242-1 in a few minutes before retrying."}
Smart Senders API: Mailbox marketplace feature. Contact support@smartlead.ai for access.
Adds mailboxes to a domain your account already bought through Smart Senders, and bills them in the same call. This is the API equivalent of adding mailboxes to an existing domain in the app.Behavior:
No new order. The mailboxes join the order the domain was bought under, and the response’s order_id is that order.
Billed on the domain’s mailbox subscription. Its quantity goes up by the number of mailboxes added, at the rate the domain’s existing mailboxes are on. The prorated amount for the rest of the current billing period is added to your next invoice and paid with the card on file. Nothing is charged at call time, the renewal date does not change, and the request takes no card or payment token.
Delivered later. The mailboxes are created after the call returns and are usable once delivered, as with any Smart Senders purchase.
Safe to retry. Resending the identical request never bills twice. See Retries.
Account. Any API key authenticates, but only accounts enabled for purchases over the API can buy. Other accounts get 403 API_PURCHASE_NOT_ENABLED and are not charged. To be enabled, contact support@smartlead.ai.Domain. The domain must be:
On your account, under the order you name in order_id
A ZapMail domain that is not pre-warmed. ZapMail is the only provider that can add mailboxes to a domain it already holds, and a pre-warmed domain would bill new, unwarmed mailboxes at the pre-warmed rate. ZapMail Infra domains are not supported either.
Live: delivered, and no longer being set up. A domain whose mailboxes were all deleted still counts, and can take new ones.
Still in use: not deleted, replaced, failed to set up, refunded, or scheduled for deletion as a whole domain
On an active mailbox subscription
Five mailboxes per domain. A domain can have at most 5 mailboxes: the ones it already has, paid or delivered, plus the ones in the request. Mailboxes scheduled for deletion count until they are deleted. A domain usually has at least one mailbox, so one request can usually add at most four.New addresses only. An address must not already exist on the domain or appear twice in the request. The address of a mailbox scheduled for deletion can’t be reused (restore that mailbox to keep it), and neither can the address of a deleted mailbox until the provider has finished removing it.
ID of the order the domain was bought under: the order_id returned by Place Order, also listed with each domain by Get Purchased Domain List. Leading and trailing spaces are ignored.
The local part (jane) or the full address on the same domain (jane@example.com). Lowercased on arrival. Letters, digits, ., _ and - only, starting and ending with a letter or digit, with no two dots in a row and at most 64 characters before the @.
Absolute http or https URL of the profile picture, at most 2,000 characters. The picture is fetched from this URL. Leave it out, or send null or an empty string, for no picture.
A 201 means the mailboxes were billed and queued for creation; they are usable once delivered. If they don’t arrive, contact support@smartlead.ai rather than resending: their addresses are now taken, so a repeat request is refused with MAILBOX_ALREADY_EXISTS.
{ "status": "error", "code": "MAILBOX_LIMIT_EXCEEDED", "message": "A domain can have at most 5 mailboxes. example.com already has 4, so only 1 more can be added; 2 requested"}
Branch on code. The message is written for the end customer and can be shown as it is; for billing errors it says whether the customer was charged. API key errors are the exception: they return 401 with only a message. An unexpected error returns 500 without a code, and nothing was charged.
Retrying unchanged gets the same answer, so fix the request or the account first. The exception is ADD_MAILBOXES_IN_PROGRESS, which clears on its own.
HTTP
code
When
400
INVALID_JSON
The body is not valid JSON
400
MISSING_DOMAIN
domain is missing or is not a domain name
400
MISSING_ORDER_ID
order_id is missing
400
MISSING_MAILBOXES
mailboxes is missing or empty
400
INVALID_MAILBOX
An entry has no mailbox, or it is not a valid local part or address
400
INVALID_MAILBOX_NAME
first_name or last_name is missing or blank
400
MAILBOX_DOMAIN_MISMATCH
A full address is not on domain
400
INVALID_PROFILE_PIC
profile_pic is not an absolute http(s) URL of at most 2,000 characters
404
DOMAIN_NOT_FOUND
No domain with that name on that order on your account
409
DOMAIN_AMBIGUOUS
The domain is recorded more than once on the order. Contact support
409
DOMAIN_DELETED
The domain has been deleted
409
DOMAIN_REPLACED
The domain was replaced. Add the mailboxes to the replacement domain instead
409
DOMAIN_FAILED
The domain failed to set up. Contact support
409
DOMAIN_CREDITED
The domain was refunded
409
DOMAIN_SCHEDULED_FOR_DELETION
The whole domain is scheduled for deletion. Restore it, then try again
400
VENDOR_UNAVAILABLE
The domain’s provider can’t be determined (contact support), or adding mailboxes is temporarily unavailable (try again later). The message says which
400
VENDOR_NOT_SUPPORTED
The domain is not a ZapMail domain
400
VENDOR_PREWARMED
The domain is a pre-warmed ZapMail domain
409
DOMAIN_NOT_LIVE
The domain is still being set up
409
NO_ACTIVE_MAILBOX_SUBSCRIPTION
The domain has no mailbox subscription to add to. Contact support
409
NO_PARENT_ORDER
The domain’s original order can’t be found. Contact support
409
MAILBOX_LIMIT_EXCEEDED
The domain would have more than 5 mailboxes
409
DOMAIN_FULL_PENDING_DELETION
The mailboxes would fit once the domain’s mailboxes pending deletion are gone. The body lists them in pending_mailboxes; permanently deleting one frees a slot
409
MAILBOX_ALREADY_EXISTS
An address already exists on the domain, or appears twice in the request
409
MAILBOX_PENDING_DELETION
An address belongs to a mailbox scheduled for deletion, or to a deleted mailbox the provider hasn’t finished removing
409
ADD_MAILBOXES_IN_PROGRESS
Another request is adding mailboxes to this domain, or to another domain on the same mailbox subscription. Retry once it finishes
When more than one of the domain conditions applies (DOMAIN_DELETED through NO_PARENT_ORDER), the first in this table is returned.
An identical request never bills twice. Identical means the same set of mailbox names on the same domain, in any order.
A changed request is fine too. Mailboxes left by an earlier attempt that was never charged are discarded and replaced by the new ones.
Overlapping requests are refused. Only one request per domain, and one per mailbox subscription, runs at a time. The others get 409 ADD_MAILBOXES_IN_PROGRESS and are not billed. Domains bought together in one order share a mailbox subscription, so a request for one can hold up a request for another.
Timeouts and unknown outcomes. Allow at least 60 seconds for a response. If the call times out, the connection drops, or you get ADD_MAILBOXES_STATUS_UNKNOWN, wait 5 minutes and resend the identical request:
The retry gets
Meaning
201
The first call did not go through; this one was billed
409 MAILBOX_ALREADY_EXISTS, or MAILBOX_LIMIT_EXCEEDED when the domain is now full
The first call went through. Nothing more was billed
409 ADD_MAILBOXES_IN_PROGRESS
The first call is still being processed. Wait, then retry
{ "status": "error", "code": "INVALID_MAILBOX", "message": "Mailbox jane..doe is not a valid email local part"}
{ "message": "Invalid API Key"}
{ "status": "error", "code": "DOMAIN_NOT_FOUND", "message": "We couldn't find example.com on order SS-1712345678901-4242-1 on your account. Check the domain name and the id of the order it was bought under."}
{ "status": "error", "code": "MAILBOX_LIMIT_EXCEEDED", "message": "A domain can have at most 5 mailboxes. example.com already has 4, so only 1 more can be added; 2 requested"}
{ "status": "error", "code": "DOMAIN_FULL_PENDING_DELETION", "message": "Domain example.com has no free mailbox slots because 1 mailbox is pending deletion. Permanently delete one to free a slot.", "pending_mailboxes": [ { "id": 987654, "from_email": "old@example.com", "scheduled_delete_at": "2026-11-02T00:00:00.000Z" } ]}
{ "status": "error", "code": "ADD_MAILBOXES_IN_PROGRESS", "message": "Mailboxes are already being added to this domain. Wait for that request to finish before retrying."}
{ "status": "error", "code": "ADD_MAILBOXES_STATUS_UNKNOWN", "message": "We couldn't confirm whether these mailboxes were added. To avoid being billed twice, check order SS-1712345678901-4242-1 in a few minutes before retrying."}
{"docsConfig":{"$schema":"https://mintlify.com/docs.json","theme":"mint","name":"SmartLead API","colors":{"primary":"#000566","light":"#757AE9","dark":"#000566"},"favicon":"https://mintcdn.com/smartlead/COEjuXjCS9X-N73L/smartleadHighResLogoSL.png?fit=max\u0026auto=format\u0026n=COEjuXjCS9X-N73L\u0026q=85\u0026s=b10b8accf21ec19997322be83b71af46","logo":{"light":"https://mintcdn.com/smartlead/COEjuXjCS9X-N73L/smartleadHighResLogoSL.png?fit=max\u0026auto=format\u0026n=COEjuXjCS9X-N73L\u0026q=85\u0026s=b10b8accf21ec19997322be83b71af46","dark":"https://mintcdn.com/smartlead/COEjuXjCS9X-N73L/smartleadHighResLogoSL.png?fit=max\u0026auto=format\u0026n=COEjuXjCS9X-N73L\u0026q=85\u0026s=b10b8accf21ec19997322be83b71af46"},"navbar":{"links":[{"label":"Support","href":"mailto:support@smartlead.ai"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.smartlead.ai"}},"seo":{"metatags":{"og:site_name":"SmartLead API Documentation","og:description":"Automate cold email outreach with the SmartLead API — manage campaigns, leads, email accounts, sequences, and analytics programmatically","og:image":"https://api.smartlead.ai/smartleadHighResLogoSL.png","twitter:site":"@smartlead_ai"},"indexing":"navigable"},"footer":{"socials":{"twitter":"https://twitter.com/smartlead_ai","linkedin":"https://www.linkedin.com/company/smartlead-ai"}},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Community","href":"https://discord.gg/smartlead","icon":"discord"},{"anchor":"Blog","href":"https://smartlead.ai/blog","icon":"newspaper"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"smartlead","hasAudioNarration":false,"actualSubdomain":"smartlead","customDomains":["api.smartlead.ai"],"gitSource":{"type":"github","owner":"smartlead-public","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aeaf6637dfaf580583a4abc","clientVersion":"0.0.4102","searchFilterCounts":[{"language":"default","tag":"API Reference","count":245},{"language":"default","tag":"Campaign Management","count":28},{"language":"default","tag":"Master Inbox","count":28},{"language":"default","tag":"Smart Delivery","count":28},{"language":"default","tag":"Smart Prospect","count":26},{"language":"default","tag":"Global Analytics","count":23},{"language":"default","tag":"Documentation","count":17},{"language":"default","tag":"Campaign Leads","count":16},{"language":"default","tag":"Email Account Management","count":15},{"language":"default","tag":"Lead Management","count":12}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"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":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/smart-senders/add-mailboxes","slug":"/api-reference/smart-senders/add-mailboxes","pageMetadata":{"title":"Add Mailboxes to Domain","api":"POST https://smart-senders.smartlead.ai/api/v1/smart-senders/add-mailboxes-to-domain","description":"Add mailboxes to a domain you already bought through Smart Senders, billed on the domain's existing mailbox subscription","href":"/api-reference/smart-senders/add-mailboxes"},"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: \"Add mailboxes to a domain you already bought through Smart Senders, billed on the domain’s existing mailbox subscription\"\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`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Expandable,Heading,Note,ParamField,ResponseField,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,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:[_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Smart Senders API`}),`: Mailbox marketplace feature. Contact `,_jsx(_components.a,{href:`mailto:support@smartlead.ai`,children:`support@smartlead.ai`}),` for access.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`overview`,children:`Overview`}),`\n`,_jsx(_components.p,{children:`Adds mailboxes to a domain your account already bought through Smart Senders, and bills them in the same call. This is the API equivalent of adding mailboxes to an existing domain in the app.`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Behavior`}),`:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`No new order.`}),` The mailboxes join the order the domain was bought under, and the response’s `,_jsx(_components.code,{children:`order_id`}),` is that order.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Billed on the domain’s mailbox subscription.`}),` Its quantity goes up by the number of mailboxes added, at the rate the domain’s existing mailboxes are on. The prorated amount for the rest of the current billing period is added to your next invoice and paid with the card on file. Nothing is charged at call time, the renewal date does not change, and the request takes no card or payment token.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Delivered later.`}),` The mailboxes are created after the call returns and are usable once delivered, as with any Smart Senders purchase.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Safe to retry.`}),` Resending the identical request never bills twice. See `,_jsx(_components.a,{href:`#retries`,children:`Retries`}),`.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`requirements`,children:`Requirements`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Account.`}),` Any API key authenticates, but only accounts enabled for purchases over the API can buy. Other accounts get `,_jsx(_components.code,{children:`403 API_PURCHASE_NOT_ENABLED`}),` and are not charged. To be enabled, contact `,_jsx(_components.a,{href:`mailto:support@smartlead.ai`,children:`support@smartlead.ai`}),`.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Domain.`}),` The domain must be:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`On your account, under the order you name in `,_jsx(_components.code,{children:`order_id`})]}),`\n`,_jsx(_components.li,{children:`A ZapMail domain that is not pre-warmed. ZapMail is the only provider that can add mailboxes to a domain it already holds, and a pre-warmed domain would bill new, unwarmed mailboxes at the pre-warmed rate. ZapMail Infra domains are not supported either.`}),`\n`,_jsx(_components.li,{children:`Live: delivered, and no longer being set up. A domain whose mailboxes were all deleted still counts, and can take new ones.`}),`\n`,_jsx(_components.li,{children:`Still in use: not deleted, replaced, failed to set up, refunded, or scheduled for deletion as a whole domain`}),`\n`,_jsx(_components.li,{children:`On an active mailbox subscription`}),`\n`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Five mailboxes per domain.`}),` A domain can have at most 5 mailboxes: the ones it already has, paid or delivered, plus the ones in the request. Mailboxes scheduled for deletion count until they are deleted. A domain usually has at least one mailbox, so one request can usually add at most four.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`New addresses only.`}),` An address must not already exist on the domain or appear twice in the request. The address of a mailbox scheduled for deletion can’t be reused (restore that mailbox to keep it), and neither can the address of a deleted mailbox until the provider has finished removing it.`]}),`\n`,_jsx(Heading,{level:`2`,id:`query-parameters`,children:`Query Parameters`}),`\n`,_jsx(ParamField,{query:`api_key`,type:`string`,required:true,id:`param-api-key`,children:_jsx(_components.p,{children:`API key used to authenticate and authorise the request.`})}),`\n`,_jsx(Heading,{level:`2`,id:`body-parameters`,children:`Body Parameters`}),`\n`,_jsx(ParamField,{body:`domain`,type:`string`,required:true,id:`param-domain`,children:_jsxs(_components.p,{children:[`Name of the domain to add mailboxes to, e.g. `,_jsx(_components.code,{children:`example.com`}),`. Case and leading or trailing spaces are ignored.`]})}),`\n`,_jsx(ParamField,{body:`order_id`,type:`string`,required:true,id:`param-order-id`,children:_jsxs(_components.p,{children:[`ID of the order the domain was bought under: the `,_jsx(_components.code,{children:`order_id`}),` returned by `,_jsx(_components.a,{href:`/api-reference/smart-senders/place-order`,children:`Place Order`}),`, also listed with each domain by `,_jsx(_components.a,{href:`/api-reference/smart-senders/domain-list`,children:`Get Purchased Domain List`}),`. Leading and trailing spaces are ignored.`]})}),`\n`,_jsxs(ParamField,{body:`mailboxes`,type:`object[]`,required:true,id:`param-mailboxes`,children:[_jsxs(_components.p,{children:[`Mailboxes to add. At least one, and no more than the domain has room for (see `,_jsx(_components.a,{href:`#requirements`,children:`Requirements`}),`). Unknown fields are ignored.`]}),_jsxs(Expandable,{title:`Mailbox Object`,children:[_jsx(ParamField,{body:`mailbox`,type:`string`,required:true,id:`param-mailbox`,children:_jsxs(_components.p,{children:[`The local part (`,_jsx(_components.code,{children:`jane`}),`) or the full address on the same domain (`,_jsx(_components.code,{children:`jane@example.com`}),`). Lowercased on arrival. Letters, digits, `,_jsx(_components.code,{children:`.`}),`, `,_jsx(_components.code,{children:`_`}),` and `,_jsx(_components.code,{children:`-`}),` only, starting and ending with a letter or digit, with no two dots in a row and at most 64 characters before the `,_jsx(_components.code,{children:`@`}),`.`]})}),_jsx(ParamField,{body:`first_name`,type:`string`,required:true,id:`param-first-name`,children:_jsx(_components.p,{children:`First name shown on the mailbox. Must not be blank.`})}),_jsx(ParamField,{body:`last_name`,type:`string`,required:true,id:`param-last-name`,children:_jsx(_components.p,{children:`Last name shown on the mailbox. Must not be blank.`})}),_jsx(ParamField,{body:`profile_pic`,type:`string`,id:`param-profile-pic`,children:_jsxs(_components.p,{children:[`Absolute `,_jsx(_components.code,{children:`http`}),` or `,_jsx(_components.code,{children:`https`}),` URL of the profile picture, at most 2,000 characters. The picture is fetched from this URL. Leave it out, or send `,_jsx(_components.code,{children:`null`}),` or an empty string, for no picture.`]})})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`headers`,children:`Headers`}),`\n`,_jsx(ParamField,{header:`Content-Type`,type:`string`,required:true,id:`param-content-type`,children:_jsxs(_components.p,{children:[`Must be `,_jsx(_components.code,{children:`application/json`})]})}),`\n`,`\n`,_jsx(Heading,{level:`2`,id:`response-fields`,children:`Response Fields`}),`\n`,_jsx(ResponseField,{name:`status`,type:`string`,id:`param-status`,children:_jsxs(_components.p,{children:[`Always `,_jsx(_components.code,{children:`ORDER_PLACEMENT_SUCCESS`}),` on success`]})}),`\n`,_jsx(ResponseField,{name:`order_id`,type:`string`,id:`param-order-id-1`,children:_jsx(_components.p,{children:`The order the domain was bought under. The mailboxes are added to this order.`})}),`\n`,_jsx(ResponseField,{name:`data`,type:`object`,id:`param-data`,children:_jsxs(Expandable,{title:`Data Object`,children:[_jsx(ResponseField,{name:`order_id`,type:`string`,id:`param-order-id-2`,children:_jsxs(_components.p,{children:[`Same as the top-level `,_jsx(_components.code,{children:`order_id`})]})}),_jsx(ResponseField,{name:`domain_id`,type:`number`,id:`param-domain-id`,children:_jsx(_components.p,{children:`ID of the domain`})}),_jsx(ResponseField,{name:`domain_name`,type:`string`,id:`param-domain-name`,children:_jsx(_components.p,{children:`The domain’s name, lowercased`})}),_jsx(ResponseField,{name:`quantity`,type:`number`,id:`param-quantity`,children:_jsx(_components.p,{children:`Number of mailboxes added by this request`})}),_jsx(ResponseField,{name:`mailbox_count_after`,type:`number`,id:`param-mailbox-count-after`,children:_jsx(_components.p,{children:`The domain’s mailbox count, including the ones just added`})}),_jsx(ResponseField,{name:`mailboxes`,type:`string[]`,id:`param-mailboxes-1`,children:_jsx(_components.p,{children:`Full addresses of the mailboxes added, lowercased`})})]})}),`\n`,_jsxs(_components.p,{children:[`A `,_jsx(_components.code,{children:`201`}),` means the mailboxes were billed and queued for creation; they are usable once delivered. If they don’t arrive, contact `,_jsx(_components.a,{href:`mailto:support@smartlead.ai`,children:`support@smartlead.ai`}),` rather than resending: their addresses are now taken, so a repeat request is refused with `,_jsx(_components.code,{children:`MAILBOX_ALREADY_EXISTS`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`response-codes`,children:`Response Codes`}),`\n`,_jsx(ResponseField,{name:`201`,type:`Created`,id:`param-201`,children:_jsx(_components.p,{children:`Mailboxes billed and queued for creation`})}),`\n`,_jsx(ResponseField,{name:`400`,type:`Bad Request`,id:`param-400`,children:_jsxs(_components.p,{children:[`The request failed validation, or the domain’s provider does not support adding mailboxes. See `,_jsx(_components.a,{href:`#errors`,children:`Errors`})]})}),`\n`,_jsx(ResponseField,{name:`401`,type:`Unauthorized`,id:`param-401`,children:_jsx(_components.p,{children:`Missing or invalid API key, expired plan, or API access denied for the account`})}),`\n`,_jsx(ResponseField,{name:`403`,type:`Forbidden`,id:`param-403`,children:_jsx(_components.p,{children:`The account is not enabled for purchases over the API. Not charged`})}),`\n`,_jsx(ResponseField,{name:`404`,type:`Not Found`,id:`param-404`,children:_jsx(_components.p,{children:`No domain with that name on that order on your account, or the domain’s mailbox subscription can’t be found. Not charged`})}),`\n`,_jsx(ResponseField,{name:`409`,type:`Conflict`,id:`param-409`,children:_jsx(_components.p,{children:`The domain can’t take these mailboxes (its state, the five-mailbox limit, or an address clash), or another request for it is running. Not charged`})}),`\n`,_jsx(ResponseField,{name:`429`,type:`Too Many Requests`,id:`param-429`,children:_jsx(_components.p,{children:`Rate limited. Not charged; retry with backoff`})}),`\n`,_jsx(ResponseField,{name:`500`,type:`Internal Server Error`,id:`param-500`,children:_jsxs(_components.p,{children:[`Billing failed or its outcome is unknown (read the `,_jsx(_components.code,{children:`code`}),` and message), or an unexpected error occurred before billing (no `,_jsx(_components.code,{children:`code`}),`; not charged)`]})}),`\n`,_jsx(ResponseField,{name:`503`,type:`Service Unavailable`,id:`param-503`,children:_jsx(_components.p,{children:`Billing is temporarily unavailable. Not charged; retry with backoff`})}),`\n`,_jsx(Heading,{level:`2`,id:`errors`,children:`Errors`}),`\n`,_jsx(_components.p,{children:`Errors have this shape:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`5`,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:`5`,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:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"error\"`}),_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:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"MAILBOX_LIMIT_EXCEEDED\"`}),_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:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"A domain can have at most 5 mailboxes. example.com already has 4, so only 1 more can be added; 2 requested\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Branch on `,_jsx(_components.code,{children:`code`}),`. The `,_jsx(_components.code,{children:`message`}),` is written for the end customer and can be shown as it is; for billing errors it says whether the customer was charged. API key errors are the exception: they return `,_jsx(_components.code,{children:`401`}),` with only a `,_jsx(_components.code,{children:`message`}),`. An unexpected error returns `,_jsx(_components.code,{children:`500`}),` without a `,_jsx(_components.code,{children:`code`}),`, and nothing was charged.`]}),`\n`,_jsx(Heading,{level:`3`,id:`before-billing-nothing-is-charged`,children:`Before billing: nothing is charged`}),`\n`,_jsxs(_components.p,{children:[`Retrying unchanged gets the same answer, so fix the request or the account first. The exception is `,_jsx(_components.code,{children:`ADD_MAILBOXES_IN_PROGRESS`}),`, which clears on its own.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`HTTP`}),_jsx(_components.th,{children:_jsx(_components.code,{children:`code`})}),_jsx(_components.th,{children:`When`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`INVALID_JSON`})}),_jsx(_components.td,{children:`The body is not valid JSON`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`MISSING_DOMAIN`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`domain`}),` is missing or is not a domain name`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`MISSING_ORDER_ID`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`order_id`}),` is missing`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`MISSING_MAILBOXES`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`mailboxes`}),` is missing or empty`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`INVALID_MAILBOX`})}),_jsxs(_components.td,{children:[`An entry has no `,_jsx(_components.code,{children:`mailbox`}),`, or it is not a valid local part or address`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`INVALID_MAILBOX_NAME`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`first_name`}),` or `,_jsx(_components.code,{children:`last_name`}),` is missing or blank`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`MAILBOX_DOMAIN_MISMATCH`})}),_jsxs(_components.td,{children:[`A full address is not on `,_jsx(_components.code,{children:`domain`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`INVALID_PROFILE_PIC`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`profile_pic`}),` is not an absolute http(s) URL of at most 2,000 characters`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`404`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`DOMAIN_NOT_FOUND`})}),_jsx(_components.td,{children:`No domain with that name on that order on your account`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`409`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`DOMAIN_AMBIGUOUS`})}),_jsx(_components.td,{children:`The domain is recorded more than once on the order. Contact support`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`409`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`DOMAIN_DELETED`})}),_jsx(_components.td,{children:`The domain has been deleted`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`409`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`DOMAIN_REPLACED`})}),_jsx(_components.td,{children:`The domain was replaced. Add the mailboxes to the replacement domain instead`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`409`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`DOMAIN_FAILED`})}),_jsx(_components.td,{children:`The domain failed to set up. Contact support`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`409`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`DOMAIN_CREDITED`})}),_jsx(_components.td,{children:`The domain was refunded`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`409`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`DOMAIN_SCHEDULED_FOR_DELETION`})}),_jsx(_components.td,{children:`The whole domain is scheduled for deletion. Restore it, then try again`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`VENDOR_UNAVAILABLE`})}),_jsx(_components.td,{children:`The domain’s provider can’t be determined (contact support), or adding mailboxes is temporarily unavailable (try again later). The message says which`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`VENDOR_NOT_SUPPORTED`})}),_jsx(_components.td,{children:`The domain is not a ZapMail domain`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`VENDOR_PREWARMED`})}),_jsx(_components.td,{children:`The domain is a pre-warmed ZapMail domain`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`409`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`DOMAIN_NOT_LIVE`})}),_jsx(_components.td,{children:`The domain is still being set up`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`409`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`NO_ACTIVE_MAILBOX_SUBSCRIPTION`})}),_jsx(_components.td,{children:`The domain has no mailbox subscription to add to. Contact support`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`409`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`NO_PARENT_ORDER`})}),_jsx(_components.td,{children:`The domain’s original order can’t be found. Contact support`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`409`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`MAILBOX_LIMIT_EXCEEDED`})}),_jsx(_components.td,{children:`The domain would have more than 5 mailboxes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`409`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`DOMAIN_FULL_PENDING_DELETION`})}),_jsxs(_components.td,{children:[`The mailboxes would fit once the domain’s mailboxes pending deletion are gone. The body lists them in `,_jsx(_components.code,{children:`pending_mailboxes`}),`; permanently deleting one frees a slot`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`409`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`MAILBOX_ALREADY_EXISTS`})}),_jsx(_components.td,{children:`An address already exists on the domain, or appears twice in the request`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`409`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`MAILBOX_PENDING_DELETION`})}),_jsx(_components.td,{children:`An address belongs to a mailbox scheduled for deletion, or to a deleted mailbox the provider hasn’t finished removing`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`409`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`ADD_MAILBOXES_IN_PROGRESS`})}),_jsx(_components.td,{children:`Another request is adding mailboxes to this domain, or to another domain on the same mailbox subscription. Retry once it finishes`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`When more than one of the domain conditions applies (`,_jsx(_components.code,{children:`DOMAIN_DELETED`}),` through `,_jsx(_components.code,{children:`NO_PARENT_ORDER`}),`), the first in this table is returned.`]}),`\n`,_jsx(Heading,{level:`3`,id:`from-billing`,children:`From billing`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`HTTP`}),_jsx(_components.th,{children:_jsx(_components.code,{children:`code`})}),_jsx(_components.th,{children:`Charged?`}),_jsx(_components.th,{children:`What to do`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`403`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`API_PURCHASE_NOT_ENABLED`})}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`Contact support to enable purchases over the API`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`404`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`SUBSCRIPTION_NOT_FOUND`})}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`Contact support`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`409`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`SUBSCRIPTION_NOT_ACTIVE`})}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`Renew the subscription, then retry`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`409`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`SUBSCRIPTION_ITEM_NOT_FOUND`})}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`Contact support`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`401`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`UNAUTHORIZED`})}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`Check the API key`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`429`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`RATE_LIMITED`})}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`Retry the identical request with backoff`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`503`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`BILLING_UNAVAILABLE`})}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`Retry the identical request with backoff`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`500`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`ADD_MAILBOXES_FAILED`}),`, message says you have not been charged`]}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`Retry the identical request`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`500`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`ADD_MAILBOXES_FAILED`}),`, message says to contact support`]}),_jsx(_components.td,{children:`Possibly`}),_jsx(_components.td,{children:`Stop and contact support. Do not retry`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`500`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`ADD_MAILBOXES_STATUS_UNKNOWN`})}),_jsx(_components.td,{children:`Unknown`}),_jsxs(_components.td,{children:[`Wait 5 minutes, then resend the identical request (see `,_jsx(_components.a,{href:`#retries`,children:`Retries`}),`)`]})]})]})]}),`\n`,_jsxs(_components.p,{children:[`Billing can also refuse with a code of its own that is not listed here. It arrives with billing’s status when that is a 4xx, and as a `,_jsx(_components.code,{children:`500`}),` otherwise.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`ADD_MAILBOXES_FAILED`}),` covers two outcomes, and only the message tells them apart. If it says to contact support, the charge may stand: do not retry.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`retries`,children:`Retries`}),`\n`,_jsx(_components.p,{children:`Retrying is safe:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`An identical request never bills twice.`}),` Identical means the same set of mailbox names on the same domain, in any order.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`A changed request is fine too.`}),` Mailboxes left by an earlier attempt that was never charged are discarded and replaced by the new ones.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Overlapping requests are refused.`}),` Only one request per domain, and one per mailbox subscription, runs at a time. The others get `,_jsx(_components.code,{children:`409 ADD_MAILBOXES_IN_PROGRESS`}),` and are not billed. Domains bought together in one order share a mailbox subscription, so a request for one can hold up a request for another.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Timeouts and unknown outcomes.`}),` Allow at least 60 seconds for a response. If the call times out, the connection drops, or you get `,_jsx(_components.code,{children:`ADD_MAILBOXES_STATUS_UNKNOWN`}),`, wait 5 minutes and resend the identical request:`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`The retry gets`}),_jsx(_components.th,{children:`Meaning`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`201`})}),_jsx(_components.td,{children:`The first call did not go through; this one was billed`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`409 MAILBOX_ALREADY_EXISTS`}),`, or `,_jsx(_components.code,{children:`MAILBOX_LIMIT_EXCEEDED`}),` when the domain is now full`]}),_jsx(_components.td,{children:`The first call went through. Nothing more was billed`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`409 ADD_MAILBOXES_IN_PROGRESS`})}),_jsx(_components.td,{children:`The first call is still being processed. Wait, then retry`})]})]})]}),`\n`,`\n`,_jsx(Heading,{level:`2`,id:`related-endpoints`,children:`Related Endpoints`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/api-reference/smart-senders/domain-list`,children:`Get Purchased Domain List`}),` - Find your domains and the orders they were bought under`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/api-reference/smart-senders/place-order`,children:`Place Order`}),` - Buy new domains with mailboxes`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/api-reference/smart-senders/order-details`,children:`Get Order Details`}),` - Check the status of an order`]}),`\n`]})]})}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":"Add Mailboxes to Domain","api":"POST https://smart-senders.smartlead.ai/api/v1/smart-senders/add-mailboxes-to-domain","description":"Add mailboxes to a domain you already bought through Smart Senders, billed on the domain's existing mailbox subscription","href":"/api-reference/smart-senders/add-mailboxes"}}},"mdxSourceWithNoJs":{"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`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Expandable,Heading,Note,ParamField,RequestExample,ResponseExample,ResponseField,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!RequestExample)_missingMdxReference(`RequestExample`,true);if(!ResponseExample)_missingMdxReference(`ResponseExample`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Smart Senders API`}),`: Mailbox marketplace feature. Contact `,_jsx(_components.a,{href:`mailto:support@smartlead.ai`,children:`support@smartlead.ai`}),` for access.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`overview`,children:`Overview`}),`\n`,_jsx(_components.p,{children:`Adds mailboxes to a domain your account already bought through Smart Senders, and bills them in the same call. This is the API equivalent of adding mailboxes to an existing domain in the app.`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Behavior`}),`:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`No new order.`}),` The mailboxes join the order the domain was bought under, and the response’s `,_jsx(_components.code,{children:`order_id`}),` is that order.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Billed on the domain’s mailbox subscription.`}),` Its quantity goes up by the number of mailboxes added, at the rate the domain’s existing mailboxes are on. The prorated amount for the rest of the current billing period is added to your next invoice and paid with the card on file. Nothing is charged at call time, the renewal date does not change, and the request takes no card or payment token.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Delivered later.`}),` The mailboxes are created after the call returns and are usable once delivered, as with any Smart Senders purchase.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Safe to retry.`}),` Resending the identical request never bills twice. See `,_jsx(_components.a,{href:`#retries`,children:`Retries`}),`.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`requirements`,children:`Requirements`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Account.`}),` Any API key authenticates, but only accounts enabled for purchases over the API can buy. Other accounts get `,_jsx(_components.code,{children:`403 API_PURCHASE_NOT_ENABLED`}),` and are not charged. To be enabled, contact `,_jsx(_components.a,{href:`mailto:support@smartlead.ai`,children:`support@smartlead.ai`}),`.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Domain.`}),` The domain must be:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`On your account, under the order you name in `,_jsx(_components.code,{children:`order_id`})]}),`\n`,_jsx(_components.li,{children:`A ZapMail domain that is not pre-warmed. ZapMail is the only provider that can add mailboxes to a domain it already holds, and a pre-warmed domain would bill new, unwarmed mailboxes at the pre-warmed rate. ZapMail Infra domains are not supported either.`}),`\n`,_jsx(_components.li,{children:`Live: delivered, and no longer being set up. A domain whose mailboxes were all deleted still counts, and can take new ones.`}),`\n`,_jsx(_components.li,{children:`Still in use: not deleted, replaced, failed to set up, refunded, or scheduled for deletion as a whole domain`}),`\n`,_jsx(_components.li,{children:`On an active mailbox subscription`}),`\n`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Five mailboxes per domain.`}),` A domain can have at most 5 mailboxes: the ones it already has, paid or delivered, plus the ones in the request. Mailboxes scheduled for deletion count until they are deleted. A domain usually has at least one mailbox, so one request can usually add at most four.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`New addresses only.`}),` An address must not already exist on the domain or appear twice in the request. The address of a mailbox scheduled for deletion can’t be reused (restore that mailbox to keep it), and neither can the address of a deleted mailbox until the provider has finished removing it.`]}),`\n`,_jsx(Heading,{level:`2`,id:`query-parameters`,children:`Query Parameters`}),`\n`,_jsx(ParamField,{query:`api_key`,type:`string`,required:true,id:`param-api-key`,children:_jsx(_components.p,{children:`API key used to authenticate and authorise the request.`})}),`\n`,_jsx(Heading,{level:`2`,id:`body-parameters`,children:`Body Parameters`}),`\n`,_jsx(ParamField,{body:`domain`,type:`string`,required:true,id:`param-domain`,children:_jsxs(_components.p,{children:[`Name of the domain to add mailboxes to, e.g. `,_jsx(_components.code,{children:`example.com`}),`. Case and leading or trailing spaces are ignored.`]})}),`\n`,_jsx(ParamField,{body:`order_id`,type:`string`,required:true,id:`param-order-id`,children:_jsxs(_components.p,{children:[`ID of the order the domain was bought under: the `,_jsx(_components.code,{children:`order_id`}),` returned by `,_jsx(_components.a,{href:`/api-reference/smart-senders/place-order`,children:`Place Order`}),`, also listed with each domain by `,_jsx(_components.a,{href:`/api-reference/smart-senders/domain-list`,children:`Get Purchased Domain List`}),`. Leading and trailing spaces are ignored.`]})}),`\n`,_jsxs(ParamField,{body:`mailboxes`,type:`object[]`,required:true,id:`param-mailboxes`,children:[_jsxs(_components.p,{children:[`Mailboxes to add. At least one, and no more than the domain has room for (see `,_jsx(_components.a,{href:`#requirements`,children:`Requirements`}),`). Unknown fields are ignored.`]}),_jsxs(Expandable,{title:`Mailbox Object`,children:[_jsx(ParamField,{body:`mailbox`,type:`string`,required:true,id:`param-mailbox`,children:_jsxs(_components.p,{children:[`The local part (`,_jsx(_components.code,{children:`jane`}),`) or the full address on the same domain (`,_jsx(_components.code,{children:`jane@example.com`}),`). Lowercased on arrival. Letters, digits, `,_jsx(_components.code,{children:`.`}),`, `,_jsx(_components.code,{children:`_`}),` and `,_jsx(_components.code,{children:`-`}),` only, starting and ending with a letter or digit, with no two dots in a row and at most 64 characters before the `,_jsx(_components.code,{children:`@`}),`.`]})}),_jsx(ParamField,{body:`first_name`,type:`string`,required:true,id:`param-first-name`,children:_jsx(_components.p,{children:`First name shown on the mailbox. Must not be blank.`})}),_jsx(ParamField,{body:`last_name`,type:`string`,required:true,id:`param-last-name`,children:_jsx(_components.p,{children:`Last name shown on the mailbox. Must not be blank.`})}),_jsx(ParamField,{body:`profile_pic`,type:`string`,id:`param-profile-pic`,children:_jsxs(_components.p,{children:[`Absolute `,_jsx(_components.code,{children:`http`}),` or `,_jsx(_components.code,{children:`https`}),` URL of the profile picture, at most 2,000 characters. The picture is fetched from this URL. Leave it out, or send `,_jsx(_components.code,{children:`null`}),` or an empty string, for no picture.`]})})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`headers`,children:`Headers`}),`\n`,_jsx(ParamField,{header:`Content-Type`,type:`string`,required:true,id:`param-content-type`,children:_jsxs(_components.p,{children:[`Must be `,_jsx(_components.code,{children:`application/json`})]})}),`\n`,_jsxs(RequestExample,{children:[_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`16`,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:`16`,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://smart-senders.smartlead.ai/api/v1/smart-senders/add-mailboxes-to-domain?api_key=YOUR_API_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:` --max-time`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 90`}),_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:` \"domain\": \"example.com\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"order_id\": \"SS-1712345678901-4242-1\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"mailboxes\": [`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` { \"mailbox\": \"jane\", \"first_name\": \"Jane\", \"last_name\": \"Doe\" },`})}),`\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:` \"mailbox\": \"sam@example.com\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"first_name\": \"Sam\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"last_name\": \"Lee\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"profile_pic\": \"https://example.com/sam.jpg\"`})}),`\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(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`Python`,numberOfLines:`30`,language:`python`,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:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`30`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` requests`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#D4D4D4`},children:`API_KEY`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"YOUR_API_KEY\"`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`payload `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"domain\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"example.com\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"order_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"SS-1712345678901-4242-1\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"mailboxes\"`}),_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\":`#D4D4D4`},children:` {`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"mailbox\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"jane\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"first_name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Jane\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"last_name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Doe\"`}),_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:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"mailbox\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"sam@example.com\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"first_name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Sam\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"last_name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Lee\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"profile_pic\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://example.com/sam.jpg\"`}),_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`,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:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`response `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` requests.post(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://smart-senders.smartlead.ai/api/v1/smart-senders/add-mailboxes-to-domain\"`}),_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:` params`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"api_key\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#D4D4D4`},children:`API_KEY`}),_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:` json`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`payload,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` timeout`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`90`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# allow at least 60 seconds`})]}),`\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:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`result `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` response.json()`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`if`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` response.status_code `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`==`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 201`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:` print`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`f`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Added `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`{`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`result[`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'data'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`][`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'quantity'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` mailboxes: `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`{`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`result[`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'data'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`][`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'mailboxes'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`else`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:` print`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`f`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`{`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`response.status_code`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` {`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`result.get(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'code'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`: `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`{`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`result.get(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'message'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`JavaScript`,numberOfLines:`32`,language:`javascript`,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:`javascript`,children:_jsxs(_components.code,{language:`javascript`,numberOfLines:`32`,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:` API_KEY`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'YOUR_API_KEY'`}),_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:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` payload`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},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:` domain:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '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:` order_id:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'SS-1712345678901-4242-1'`}),_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:` mailboxes:`}),_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\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`mailbox:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'jane'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`first_name:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Jane'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`last_name:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Doe'`}),_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:` mailbox:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'sam@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:` first_name:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Sam'`}),_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:` last_name:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Lee'`}),_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:` profile_pic:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'https://example.com/sam.jpg'`})]}),`\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`,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:`#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:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` fetch`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\" `https://smart-senders.smartlead.ai/api/v1/smart-senders/add-mailboxes-to-domain?api_key=\"}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:\"${\"}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:`API_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},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`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` method:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'POST'`}),_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:` headers:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'Content-Type'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'application/json'`}),_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:` body:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` JSON`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`stringify`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`payload`}),_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:` signal:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` AbortSignal`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`timeout`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`90000`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) `}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`// allow at least 60 seconds`})]}),`\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:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` result`}),_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:` response`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`json`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`();`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`if`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--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:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`status`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` ===`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 201`}),_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:` console`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`log`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\"`Added \"}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:\"${\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`result`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`data`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`quantity`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\" mailboxes:`\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`result`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`data`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`mailboxes`}),_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\":`#D4D4D4`},children:`} `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`else`}),_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:` console`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`log`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\"`\"}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:\"${\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`response`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`status`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:\" ${\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`result`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`code`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:\"${\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`result`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`message`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},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(Heading,{level:`2`,id:`response-fields`,children:`Response Fields`}),`\n`,_jsx(ResponseField,{name:`status`,type:`string`,id:`param-status`,children:_jsxs(_components.p,{children:[`Always `,_jsx(_components.code,{children:`ORDER_PLACEMENT_SUCCESS`}),` on success`]})}),`\n`,_jsx(ResponseField,{name:`order_id`,type:`string`,id:`param-order-id-1`,children:_jsx(_components.p,{children:`The order the domain was bought under. The mailboxes are added to this order.`})}),`\n`,_jsx(ResponseField,{name:`data`,type:`object`,id:`param-data`,children:_jsxs(Expandable,{title:`Data Object`,children:[_jsx(ResponseField,{name:`order_id`,type:`string`,id:`param-order-id-2`,children:_jsxs(_components.p,{children:[`Same as the top-level `,_jsx(_components.code,{children:`order_id`})]})}),_jsx(ResponseField,{name:`domain_id`,type:`number`,id:`param-domain-id`,children:_jsx(_components.p,{children:`ID of the domain`})}),_jsx(ResponseField,{name:`domain_name`,type:`string`,id:`param-domain-name`,children:_jsx(_components.p,{children:`The domain’s name, lowercased`})}),_jsx(ResponseField,{name:`quantity`,type:`number`,id:`param-quantity`,children:_jsx(_components.p,{children:`Number of mailboxes added by this request`})}),_jsx(ResponseField,{name:`mailbox_count_after`,type:`number`,id:`param-mailbox-count-after`,children:_jsx(_components.p,{children:`The domain’s mailbox count, including the ones just added`})}),_jsx(ResponseField,{name:`mailboxes`,type:`string[]`,id:`param-mailboxes-1`,children:_jsx(_components.p,{children:`Full addresses of the mailboxes added, lowercased`})})]})}),`\n`,_jsxs(_components.p,{children:[`A `,_jsx(_components.code,{children:`201`}),` means the mailboxes were billed and queued for creation; they are usable once delivered. If they don’t arrive, contact `,_jsx(_components.a,{href:`mailto:support@smartlead.ai`,children:`support@smartlead.ai`}),` rather than resending: their addresses are now taken, so a repeat request is refused with `,_jsx(_components.code,{children:`MAILBOX_ALREADY_EXISTS`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`response-codes`,children:`Response Codes`}),`\n`,_jsx(ResponseField,{name:`201`,type:`Created`,id:`param-201`,children:_jsx(_components.p,{children:`Mailboxes billed and queued for creation`})}),`\n`,_jsx(ResponseField,{name:`400`,type:`Bad Request`,id:`param-400`,children:_jsxs(_components.p,{children:[`The request failed validation, or the domain’s provider does not support adding mailboxes. See `,_jsx(_components.a,{href:`#errors`,children:`Errors`})]})}),`\n`,_jsx(ResponseField,{name:`401`,type:`Unauthorized`,id:`param-401`,children:_jsx(_components.p,{children:`Missing or invalid API key, expired plan, or API access denied for the account`})}),`\n`,_jsx(ResponseField,{name:`403`,type:`Forbidden`,id:`param-403`,children:_jsx(_components.p,{children:`The account is not enabled for purchases over the API. Not charged`})}),`\n`,_jsx(ResponseField,{name:`404`,type:`Not Found`,id:`param-404`,children:_jsx(_components.p,{children:`No domain with that name on that order on your account, or the domain’s mailbox subscription can’t be found. Not charged`})}),`\n`,_jsx(ResponseField,{name:`409`,type:`Conflict`,id:`param-409`,children:_jsx(_components.p,{children:`The domain can’t take these mailboxes (its state, the five-mailbox limit, or an address clash), or another request for it is running. Not charged`})}),`\n`,_jsx(ResponseField,{name:`429`,type:`Too Many Requests`,id:`param-429`,children:_jsx(_components.p,{children:`Rate limited. Not charged; retry with backoff`})}),`\n`,_jsx(ResponseField,{name:`500`,type:`Internal Server Error`,id:`param-500`,children:_jsxs(_components.p,{children:[`Billing failed or its outcome is unknown (read the `,_jsx(_components.code,{children:`code`}),` and message), or an unexpected error occurred before billing (no `,_jsx(_components.code,{children:`code`}),`; not charged)`]})}),`\n`,_jsx(ResponseField,{name:`503`,type:`Service Unavailable`,id:`param-503`,children:_jsx(_components.p,{children:`Billing is temporarily unavailable. Not charged; retry with backoff`})}),`\n`,_jsx(Heading,{level:`2`,id:`errors`,children:`Errors`}),`\n`,_jsx(_components.p,{children:`Errors have this shape:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`5`,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:`5`,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:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"error\"`}),_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:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"MAILBOX_LIMIT_EXCEEDED\"`}),_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:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"A domain can have at most 5 mailboxes. example.com already has 4, so only 1 more can be added; 2 requested\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Branch on `,_jsx(_components.code,{children:`code`}),`. The `,_jsx(_components.code,{children:`message`}),` is written for the end customer and can be shown as it is; for billing errors it says whether the customer was charged. API key errors are the exception: they return `,_jsx(_components.code,{children:`401`}),` with only a `,_jsx(_components.code,{children:`message`}),`. An unexpected error returns `,_jsx(_components.code,{children:`500`}),` without a `,_jsx(_components.code,{children:`code`}),`, and nothing was charged.`]}),`\n`,_jsx(Heading,{level:`3`,id:`before-billing-nothing-is-charged`,children:`Before billing: nothing is charged`}),`\n`,_jsxs(_components.p,{children:[`Retrying unchanged gets the same answer, so fix the request or the account first. The exception is `,_jsx(_components.code,{children:`ADD_MAILBOXES_IN_PROGRESS`}),`, which clears on its own.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`HTTP`}),_jsx(_components.th,{children:_jsx(_components.code,{children:`code`})}),_jsx(_components.th,{children:`When`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`INVALID_JSON`})}),_jsx(_components.td,{children:`The body is not valid JSON`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`MISSING_DOMAIN`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`domain`}),` is missing or is not a domain name`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`MISSING_ORDER_ID`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`order_id`}),` is missing`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`MISSING_MAILBOXES`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`mailboxes`}),` is missing or empty`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`INVALID_MAILBOX`})}),_jsxs(_components.td,{children:[`An entry has no `,_jsx(_components.code,{children:`mailbox`}),`, or it is not a valid local part or address`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`INVALID_MAILBOX_NAME`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`first_name`}),` or `,_jsx(_components.code,{children:`last_name`}),` is missing or blank`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`MAILBOX_DOMAIN_MISMATCH`})}),_jsxs(_components.td,{children:[`A full address is not on `,_jsx(_components.code,{children:`domain`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`INVALID_PROFILE_PIC`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`profile_pic`}),` is not an absolute http(s) URL of at most 2,000 characters`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`404`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`DOMAIN_NOT_FOUND`})}),_jsx(_components.td,{children:`No domain with that name on that order on your account`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`409`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`DOMAIN_AMBIGUOUS`})}),_jsx(_components.td,{children:`The domain is recorded more than once on the order. Contact support`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`409`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`DOMAIN_DELETED`})}),_jsx(_components.td,{children:`The domain has been deleted`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`409`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`DOMAIN_REPLACED`})}),_jsx(_components.td,{children:`The domain was replaced. Add the mailboxes to the replacement domain instead`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`409`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`DOMAIN_FAILED`})}),_jsx(_components.td,{children:`The domain failed to set up. Contact support`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`409`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`DOMAIN_CREDITED`})}),_jsx(_components.td,{children:`The domain was refunded`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`409`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`DOMAIN_SCHEDULED_FOR_DELETION`})}),_jsx(_components.td,{children:`The whole domain is scheduled for deletion. Restore it, then try again`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`VENDOR_UNAVAILABLE`})}),_jsx(_components.td,{children:`The domain’s provider can’t be determined (contact support), or adding mailboxes is temporarily unavailable (try again later). The message says which`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`VENDOR_NOT_SUPPORTED`})}),_jsx(_components.td,{children:`The domain is not a ZapMail domain`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`VENDOR_PREWARMED`})}),_jsx(_components.td,{children:`The domain is a pre-warmed ZapMail domain`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`409`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`DOMAIN_NOT_LIVE`})}),_jsx(_components.td,{children:`The domain is still being set up`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`409`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`NO_ACTIVE_MAILBOX_SUBSCRIPTION`})}),_jsx(_components.td,{children:`The domain has no mailbox subscription to add to. Contact support`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`409`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`NO_PARENT_ORDER`})}),_jsx(_components.td,{children:`The domain’s original order can’t be found. Contact support`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`409`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`MAILBOX_LIMIT_EXCEEDED`})}),_jsx(_components.td,{children:`The domain would have more than 5 mailboxes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`409`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`DOMAIN_FULL_PENDING_DELETION`})}),_jsxs(_components.td,{children:[`The mailboxes would fit once the domain’s mailboxes pending deletion are gone. The body lists them in `,_jsx(_components.code,{children:`pending_mailboxes`}),`; permanently deleting one frees a slot`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`409`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`MAILBOX_ALREADY_EXISTS`})}),_jsx(_components.td,{children:`An address already exists on the domain, or appears twice in the request`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`409`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`MAILBOX_PENDING_DELETION`})}),_jsx(_components.td,{children:`An address belongs to a mailbox scheduled for deletion, or to a deleted mailbox the provider hasn’t finished removing`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`409`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`ADD_MAILBOXES_IN_PROGRESS`})}),_jsx(_components.td,{children:`Another request is adding mailboxes to this domain, or to another domain on the same mailbox subscription. Retry once it finishes`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`When more than one of the domain conditions applies (`,_jsx(_components.code,{children:`DOMAIN_DELETED`}),` through `,_jsx(_components.code,{children:`NO_PARENT_ORDER`}),`), the first in this table is returned.`]}),`\n`,_jsx(Heading,{level:`3`,id:`from-billing`,children:`From billing`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`HTTP`}),_jsx(_components.th,{children:_jsx(_components.code,{children:`code`})}),_jsx(_components.th,{children:`Charged?`}),_jsx(_components.th,{children:`What to do`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`403`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`API_PURCHASE_NOT_ENABLED`})}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`Contact support to enable purchases over the API`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`404`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`SUBSCRIPTION_NOT_FOUND`})}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`Contact support`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`409`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`SUBSCRIPTION_NOT_ACTIVE`})}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`Renew the subscription, then retry`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`409`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`SUBSCRIPTION_ITEM_NOT_FOUND`})}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`Contact support`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`401`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`UNAUTHORIZED`})}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`Check the API key`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`429`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`RATE_LIMITED`})}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`Retry the identical request with backoff`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`503`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`BILLING_UNAVAILABLE`})}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`Retry the identical request with backoff`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`500`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`ADD_MAILBOXES_FAILED`}),`, message says you have not been charged`]}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`Retry the identical request`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`500`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`ADD_MAILBOXES_FAILED`}),`, message says to contact support`]}),_jsx(_components.td,{children:`Possibly`}),_jsx(_components.td,{children:`Stop and contact support. Do not retry`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`500`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`ADD_MAILBOXES_STATUS_UNKNOWN`})}),_jsx(_components.td,{children:`Unknown`}),_jsxs(_components.td,{children:[`Wait 5 minutes, then resend the identical request (see `,_jsx(_components.a,{href:`#retries`,children:`Retries`}),`)`]})]})]})]}),`\n`,_jsxs(_components.p,{children:[`Billing can also refuse with a code of its own that is not listed here. It arrives with billing’s status when that is a 4xx, and as a `,_jsx(_components.code,{children:`500`}),` otherwise.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`ADD_MAILBOXES_FAILED`}),` covers two outcomes, and only the message tells them apart. If it says to contact support, the charge may stand: do not retry.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`retries`,children:`Retries`}),`\n`,_jsx(_components.p,{children:`Retrying is safe:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`An identical request never bills twice.`}),` Identical means the same set of mailbox names on the same domain, in any order.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`A changed request is fine too.`}),` Mailboxes left by an earlier attempt that was never charged are discarded and replaced by the new ones.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Overlapping requests are refused.`}),` Only one request per domain, and one per mailbox subscription, runs at a time. The others get `,_jsx(_components.code,{children:`409 ADD_MAILBOXES_IN_PROGRESS`}),` and are not billed. Domains bought together in one order share a mailbox subscription, so a request for one can hold up a request for another.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Timeouts and unknown outcomes.`}),` Allow at least 60 seconds for a response. If the call times out, the connection drops, or you get `,_jsx(_components.code,{children:`ADD_MAILBOXES_STATUS_UNKNOWN`}),`, wait 5 minutes and resend the identical request:`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`The retry gets`}),_jsx(_components.th,{children:`Meaning`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`201`})}),_jsx(_components.td,{children:`The first call did not go through; this one was billed`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`409 MAILBOX_ALREADY_EXISTS`}),`, or `,_jsx(_components.code,{children:`MAILBOX_LIMIT_EXCEEDED`}),` when the domain is now full`]}),_jsx(_components.td,{children:`The first call went through. Nothing more was billed`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`409 ADD_MAILBOXES_IN_PROGRESS`})}),_jsx(_components.td,{children:`The first call is still being processed. Wait, then retry`})]})]})]}),`\n`,_jsxs(ResponseExample,{children:[_jsx(CodeBlock,{filename:`201 - Success`,numberOfLines:`12`,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:`12`,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:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"ORDER_PLACEMENT_SUCCESS\"`}),_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:` \"order_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"SS-1712345678901-4242-1\"`}),_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:` \"order_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"SS-1712345678901-4242-1\"`}),_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:` \"domain_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`12345`}),_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:` \"domain_name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"example.com\"`}),_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:` \"quantity\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`2`}),_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:` \"mailbox_count_after\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`4`}),_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:` \"mailboxes\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"jane@example.com\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"sam@example.com\"`}),_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(CodeBlock,{filename:`400 - Invalid Mailbox`,numberOfLines:`5`,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:`5`,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:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"error\"`}),_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:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"INVALID_MAILBOX\"`}),_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:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Mailbox jane..doe is not a valid email local part\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`401 - Unauthorized`,numberOfLines:`3`,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:`3`,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:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Invalid API Key\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`404 - Domain Not Found`,numberOfLines:`5`,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:`5`,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:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"error\"`}),_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:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"DOMAIN_NOT_FOUND\"`}),_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:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"We couldn't find example.com on order SS-1712345678901-4242-1 on your account. Check the domain name and the id of the order it was bought under.\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`409 - Mailbox Limit Exceeded`,numberOfLines:`5`,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:`5`,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:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"error\"`}),_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:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"MAILBOX_LIMIT_EXCEEDED\"`}),_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:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"A domain can have at most 5 mailboxes. example.com already has 4, so only 1 more can be added; 2 requested\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`409 - Domain Full Pending Deletion`,numberOfLines:`12`,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:`12`,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:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"error\"`}),_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:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"DOMAIN_FULL_PENDING_DELETION\"`}),_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:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Domain example.com has no free mailbox slots because 1 mailbox is pending deletion. Permanently delete one to free a slot.\"`}),_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:` \"pending_mailboxes\"`}),_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:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`987654`}),_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:` \"from_email\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"old@example.com\"`}),_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:` \"scheduled_delete_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-11-02T00:00:00.000Z\"`})]}),`\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`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`409 - In Progress`,numberOfLines:`5`,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:`5`,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:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"error\"`}),_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:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"ADD_MAILBOXES_IN_PROGRESS\"`}),_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:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Mailboxes are already being added to this domain. Wait for that request to finish before retrying.\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`500 - Status Unknown`,numberOfLines:`5`,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:`5`,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:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"error\"`}),_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:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"ADD_MAILBOXES_STATUS_UNKNOWN\"`}),_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:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"We couldn't confirm whether these mailboxes were added. To avoid being billed twice, check order SS-1712345678901-4242-1 in a few minutes before retrying.\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})]}),`\n`,_jsx(Heading,{level:`2`,id:`related-endpoints`,children:`Related Endpoints`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/api-reference/smart-senders/domain-list`,children:`Get Purchased Domain List`}),` - Find your domains and the orders they were bought under`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/api-reference/smart-senders/place-order`,children:`Place Order`}),` - Buy new domains with mailboxes`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/api-reference/smart-senders/order-details`,children:`Get Order Details`}),` - Check the status of an order`]}),`\n`]})]})}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":"Add Mailboxes to Domain","api":"POST https://smart-senders.smartlead.ai/api/v1/smart-senders/add-mailboxes-to-domain","description":"Add mailboxes to a domain you already bought through Smart Senders, billed on the domain's existing mailbox subscription","href":"/api-reference/smart-senders/add-mailboxes"}}}},"mdxExtracts":{"tableOfContents":[{"title":"Overview","slug":"overview","depth":2,"children":[]},{"title":"Requirements","slug":"requirements","depth":2,"children":[]},{"title":"Query Parameters","slug":"query-parameters","depth":2,"children":[]},{"title":"Body Parameters","slug":"body-parameters","depth":2,"children":[]},{"title":"Headers","slug":"headers","depth":2,"children":[]},{"title":"Response Fields","slug":"response-fields","depth":2,"children":[]},{"title":"Response Codes","slug":"response-codes","depth":2,"children":[]},{"title":"Errors","slug":"errors","depth":2,"children":[{"title":"Before billing: nothing is charged","slug":"before-billing-nothing-is-charged","depth":3,"children":[]},{"title":"From billing","slug":"from-billing","depth":3,"children":[]}]},{"title":"Retries","slug":"retries","depth":2,"children":[]},{"title":"Related Endpoints","slug":"related-endpoints","depth":2,"children":[]}],"codeExamples":{"request":{"type":"RequestExample","children":[{"filename":"cURL","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"shellscript\">\u003ccode language=\"shellscript\" numberOfLines=\"16\">\u003cspan class=\"line\">\u003cspan style=\"color:#953800;--shiki-dark:#DCDCAA\">curl\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -X\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> POST\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"https://smart-senders.smartlead.ai/api/v1/smart-senders/add-mailboxes-to-domain?api_key=YOUR_API_KEY\"\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -H\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"Content-Type: application/json\"\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> --max-time\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\"> 90\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -d\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> '{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"domain\": \"example.com\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"order_id\": \"SS-1712345678901-4242-1\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"mailboxes\": [\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> { \"mailbox\": \"jane\", \"first_name\": \"Jane\", \"last_name\": \"Doe\" },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"mailbox\": \"sam@example.com\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"first_name\": \"Sam\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"last_name\": \"Lee\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"profile_pic\": \"https://example.com/sam.jpg\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> ]\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> }'\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"Python","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"python\">\u003ccode language=\"python\" numberOfLines=\"30\">\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\">import\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> requests\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#D4D4D4\">API_KEY\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\"> =\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"YOUR_API_KEY\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">payload \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"domain\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"example.com\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"order_id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"SS-1712345678901-4242-1\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"mailboxes\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"mailbox\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"jane\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"first_name\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Jane\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"last_name\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Doe\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">},\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"mailbox\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"sam@example.com\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"first_name\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Sam\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"last_name\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Lee\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"profile_pic\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"https://example.com/sam.jpg\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> ],\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">response \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> requests.post(\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"https://smart-senders.smartlead.ai/api/v1/smart-senders/add-mailboxes-to-domain\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#953800;--shiki-dark:#9CDCFE\"> params\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"api_key\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#D4D4D4\">API_KEY\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">},\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#953800;--shiki-dark:#9CDCFE\"> json\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">payload,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#953800;--shiki-dark:#9CDCFE\"> timeout\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">90\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#6E7781;--shiki-dark:#6A9955\"># allow at least 60 seconds\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">)\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">result \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> response.json()\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\">if\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> response.status_code \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">==\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\"> 201\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">:\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#DCDCAA\"> print\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">(\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">f\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Added \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">{\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">result[\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'data'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">][\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'quantity'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">]\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">}\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> mailboxes: \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">{\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">result[\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'data'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">][\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'mailboxes'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">]\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">}\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">)\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\">else\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">:\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#DCDCAA\"> print\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">(\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">f\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">{\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">response.status_code\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">}\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\"> {\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">result.get(\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'code'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">)\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">}\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">: \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">{\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">result.get(\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'message'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">)\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">}\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">)\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"JavaScript","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"javascript\">\u003ccode language=\"javascript\" numberOfLines=\"32\">\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">const\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#4FC1FF\"> API_KEY\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\"> =\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'YOUR_API_KEY'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">;\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">const\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#4FC1FF\"> payload\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\"> =\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> domain:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'example.com'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> order_id:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'SS-1712345678901-4242-1'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> mailboxes:\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> [\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> { \u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">mailbox:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'jane'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">first_name:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'Jane'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">last_name:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'Doe'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> mailbox:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'sam@example.com'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> first_name:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'Sam'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> last_name:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'Lee'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> profile_pic:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'https://example.com/sam.jpg'\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> ]\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">};\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">const\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#4FC1FF\"> response\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\"> =\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\"> await\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\"> fetch\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">(\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> `https://smart-senders.smartlead.ai/api/v1/smart-senders/add-mailboxes-to-domain?api_key=\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#569CD6\">${\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#4FC1FF\">API_KEY\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#569CD6\">}\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">`\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> method:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'POST'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> headers:\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> { \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'Content-Type'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'application/json'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> body:\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#4FC1FF\"> JSON\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\">stringify\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">(\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">payload\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">),\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> signal:\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> AbortSignal\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\">timeout\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">(\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">90000\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">) \u003c/span>\u003cspan style=\"color:#6E7781;--shiki-dark:#6A9955\">// allow at least 60 seconds\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">);\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">const\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#4FC1FF\"> result\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\"> =\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\"> await\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> response\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\">json\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">();\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\">if\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> (\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">response\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">status\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\"> ===\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\"> 201\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">) {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> console\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\">log\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">(\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">`Added \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#569CD6\">${\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">result\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">data\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">quantity\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#569CD6\">}\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> mailboxes:`\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">result\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">data\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">mailboxes\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">);\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">} \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\">else\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> console\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\">log\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">(\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">`\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#569CD6\">${\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">response\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">status\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#569CD6\">}\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#569CD6\"> ${\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">result\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">code\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#569CD6\">}\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#569CD6\">${\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">result\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">message\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#569CD6\">}\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">`\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">);\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]},"response":{"type":"ResponseExample","children":[{"filename":"201 - Success","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"12\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"status\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"ORDER_PLACEMENT_SUCCESS\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"order_id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"SS-1712345678901-4242-1\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"data\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"order_id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"SS-1712345678901-4242-1\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"domain_id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">12345\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"domain_name\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"example.com\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"quantity\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">2\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"mailbox_count_after\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">4\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"mailboxes\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"jane@example.com\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"sam@example.com\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">]\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"400 - Invalid Mailbox","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"5\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"status\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"error\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"code\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"INVALID_MAILBOX\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Mailbox jane..doe is not a valid email local part\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"401 - Unauthorized","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"3\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Invalid API Key\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"404 - Domain Not Found","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"5\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"status\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"error\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"code\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"DOMAIN_NOT_FOUND\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"We couldn't find example.com on order SS-1712345678901-4242-1 on your account. Check the domain name and the id of the order it was bought under.\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"409 - Mailbox Limit Exceeded","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"5\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"status\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"error\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"code\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"MAILBOX_LIMIT_EXCEEDED\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"A domain can have at most 5 mailboxes. example.com already has 4, so only 1 more can be added; 2 requested\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"409 - Domain Full Pending Deletion","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"12\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"status\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"error\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"code\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"DOMAIN_FULL_PENDING_DELETION\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Domain example.com has no free mailbox slots because 1 mailbox is pending deletion. Permanently delete one to free a slot.\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"pending_mailboxes\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">987654\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"from_email\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"old@example.com\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"scheduled_delete_at\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"2026-11-02T00:00:00.000Z\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> ]\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"409 - In Progress","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"5\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"status\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"error\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"code\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"ADD_MAILBOXES_IN_PROGRESS\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Mailboxes are already being added to this domain. Wait for that request to finish before retrying.\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"500 - Status Unknown","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"5\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"status\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"error\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"code\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"ADD_MAILBOXES_STATUS_UNKNOWN\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"We couldn't confirm whether these mailboxes were added. To avoid being billed twice, check order SS-1712345678901-4242-1 in a few minutes before retrying.\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]}},"endpoint":{"title":"Add Mailboxes to Domain","path":"/api/v1/smart-senders/add-mailboxes-to-domain","servers":[{"url":"https://smart-senders.smartlead.ai"}],"method":"post","request":{"security":[],"parameters":{"query":{"api_key":{"schema":[{"type":"string","description":"API key used to authenticate and authorise the request.","required":true}]}},"header":{"Content-Type":{"schema":[{"type":"string","description":"Must be `application/json`","required":true}]}},"cookie":{},"path":{}},"body":{"application/json":{"schemaArray":[{"type":"object","properties":{"domain":[{"type":"string","description":"Name of the domain to add mailboxes to, e.g. `example.com` . Case and leading or trailing spaces are ignored.","required":true}],"order_id":[{"type":"string","description":"ID of the order the domain was bought under: the `order_id` returned by Place Order , also listed with each domain by Get Purchased Domain List . Leading and trailing spaces are ignored.","required":true}],"mailboxes":[{"type":"array","items":[{"type":"object","properties":{"mailbox":[{"type":"string","description":"The local part ( `jane` ) or the full address on the same domain ( `jane@example.com` ). Lowercased on arrival. Letters, digits, `.` , `_` and `-` only, starting and ending with a letter or digit, with no two dots in a row and at most 64 characters before the `@` .","required":true}],"first_name":[{"type":"string","description":"First name shown on the mailbox. Must not be blank.","required":true}],"last_name":[{"type":"string","description":"Last name shown on the mailbox. Must not be blank.","required":true}],"profile_pic":[{"type":"string","description":"Absolute `http` or `https` URL of the profile picture, at most 2,000 characters. The picture is fetched from this URL. Leave it out, or send `null` or an empty string, for no picture."}]}}],"description":"Mailboxes to add. At least one, and no more than the domain has room for (see Requirements ). Unknown fields are ignored.","required":true}]}}],"examples":{"example":{"value":{"domain":"\u003cstring>","order_id":"\u003cstring>","mailboxes":[{"mailbox":"\u003cstring>","first_name":"\u003cstring>","last_name":"\u003cstring>","profile_pic":"\u003cstring>"}]}}}}}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"201":[{"type":"object","properties":{},"description":"Mailboxes billed and queued for creation"}],"400":[{"type":"object","properties":{},"description":"The request failed validation, or the domain’s provider does not support adding mailboxes. See Errors"}],"401":[{"type":"object","properties":{},"description":"Missing or invalid API key, expired plan, or API access denied for the account"}],"403":[{"type":"object","properties":{},"description":"The account is not enabled for purchases over the API. Not charged"}],"404":[{"type":"object","properties":{},"description":"No domain with that name on that order on your account, or the domain’s mailbox subscription can’t be found. Not charged"}],"409":[{"type":"object","properties":{},"description":"The domain can’t take these mailboxes (its state, the five-mailbox limit, or an address clash), or another request for it is running. Not charged"}],"429":[{"type":"object","properties":{},"description":"Rate limited. Not charged; retry with backoff"}],"500":[{"type":"object","properties":{},"description":"Billing failed or its outcome is unknown (read the `code` and message), or an unexpected error occurred before billing (no `code` ; not charged)"}],"503":[{"type":"object","properties":{},"description":"Billing is temporarily unavailable. Not charged; retry with backoff"}],"status":[{"type":"string","description":"Always `ORDER_PLACEMENT_SUCCESS` on success"}],"order_id":[{"type":"string","description":"The order the domain was bought under. The mailboxes are added to this order."}],"data":[{"type":"object","properties":{"order_id":[{"type":"string","description":"Same as the top-level `order_id`"}],"domain_id":[{"type":"number","description":"ID of the domain"}],"domain_name":[{"type":"string","description":"The domain’s name, lowercased"}],"quantity":[{"type":"number","description":"Number of mailboxes added by this request"}],"mailbox_count_after":[{"type":"number","description":"The domain’s mailbox count, including the ones just added"}],"mailboxes":[{"type":"array","items":[{"type":"string"}],"description":"Full addresses of the mailboxes added, lowercased"}]}}]}}],"examples":{"example":{"value":{"201":{},"400":{},"401":{},"403":{},"404":{},"409":{},"429":{},"500":{},"503":{},"status":"\u003cstring>","order_id":"\u003cstring>","data":{"order_id":"\u003cstring>","domain_id":123,"domain_name":"\u003cstring>","quantity":123,"mailbox_count_after":123,"mailboxes":["\u003cstring>"]}}}}}}},"deprecated":false}},"jsLinks":[],"subdomain":"smartlead","siteName":"SmartLead API","title":"Add Mailboxes to Domain - SmartLead API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-19T13:06:25.583Z","originalFileLocation":"api-reference/smart-senders/add-mailboxes.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=\"Add mailboxes to a domain you already bought through Smart Senders, billed on the domain\u0026#x27;s existing mailbox subscription\">\u003cmeta data-mint-head name=\"application-name\" content=\"SmartLead API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/smartlead/nfHT53KN2IkDRvL7/_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/smartlead/nfHT53KN2IkDRvL7/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/smartlead/nfHT53KN2IkDRvL7/_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/smartlead/nfHT53KN2IkDRvL7/_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/smartlead/nfHT53KN2IkDRvL7/_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/smartlead/nfHT53KN2IkDRvL7/_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/smartlead/nfHT53KN2IkDRvL7/_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/smartlead/nfHT53KN2IkDRvL7/_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/smartlead/nfHT53KN2IkDRvL7/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Add Mailboxes to Domain - SmartLead API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Automate cold email outreach with the SmartLead API — manage campaigns, leads, email accounts, sequences, and analytics programmatically\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"SmartLead API Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://api.smartlead.ai/api-reference/smart-senders/add-mailboxes\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://api.smartlead.ai/smartleadHighResLogoSL.png\">\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=\"Add Mailboxes to Domain - SmartLead API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Automate cold email outreach with the SmartLead API — manage campaigns, leads, email accounts, sequences, and analytics programmatically\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://api.smartlead.ai/smartleadHighResLogoSL.png\">\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/smartlead/nfHT53KN2IkDRvL7/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"SmartLead API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#000566\">\u003clink data-mint-head rel=\"canonical\" href=\"https://api.smartlead.ai/api-reference/smart-senders/add-mailboxes\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/smart-senders/add-mailboxes.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://api.smartlead.ai/#organization\",\"name\":\"SmartLead API\",\"url\":\"https://api.smartlead.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/smartlead/COEjuXjCS9X-N73L/smartleadHighResLogoSL.png?fit=max\u0026auto=format\u0026n=COEjuXjCS9X-N73L\u0026q=85\u0026s=b10b8accf21ec19997322be83b71af46\"}},{\"@type\":\"WebSite\",\"@id\":\"https://api.smartlead.ai#website\",\"name\":\"SmartLead API\",\"url\":\"https://api.smartlead.ai\",\"publisher\":{\"@id\":\"https://api.smartlead.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://api.smartlead.ai/api-reference/smart-senders/add-mailboxes#webpage\",\"url\":\"https://api.smartlead.ai/api-reference/smart-senders/add-mailboxes\",\"name\":\"Add Mailboxes to Domain\",\"description\":\"Add mailboxes to a domain you already bought through Smart Senders, billed on the domain's existing mailbox subscription\",\"dateModified\":\"2026-10-19T13:06:25.583Z\",\"isPartOf\":{\"@id\":\"https://api.smartlead.ai#website\"},\"breadcrumb\":{\"@id\":\"https://api.smartlead.ai/api-reference/smart-senders/add-mailboxes#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://api.smartlead.ai/api-reference/smart-senders/add-mailboxes#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Smart Senders\",\"item\":\"https://api.smartlead.ai/api-reference/smart-senders/get-otp\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Add Mailboxes to Domain\",\"item\":\"https://api.smartlead.ai/api-reference/smart-senders/add-mailboxes\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://api.smartlead.ai/api-reference/smart-senders/add-mailboxes#apireference\",\"headline\":\"Add Mailboxes to Domain\",\"name\":\"Add Mailboxes to Domain\",\"description\":\"Add mailboxes to a domain you already bought through Smart Senders, billed on the domain's existing mailbox subscription\",\"url\":\"https://api.smartlead.ai/api-reference/smart-senders/add-mailboxes\",\"mainEntityOfPage\":{\"@id\":\"https://api.smartlead.ai/api-reference/smart-senders/add-mailboxes#webpage\"},\"image\":\"https://api.smartlead.ai/smartleadHighResLogoSL.png\",\"dateModified\":\"2026-10-19T13:06:25.583Z\",\"publisher\":{\"@id\":\"https://api.smartlead.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://api.smartlead.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"SmartLead API\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"SmartLead API\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/smart-senders/add-mailboxes.md","siteName":"SmartLead API","nav":{"global":{"anchors":[{"anchor":"Community","href":"https://discord.gg/smartlead","icon":"discord"},{"anchor":"Blog","href":"https://smartlead.ai/blog","icon":"newspaper"}]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"API Reference","groups":[{"group":"Campaign Management","pages":[{"title":"Get All Campaigns","api":"GET https://server.smartlead.ai/api/v1/campaigns/","href":"/api-reference/campaigns/get-all"},{"title":"Get Campaign by ID","api":"GET https://server.smartlead.ai/api/v1/campaigns/{campaign_id}","href":"/api-reference/campaigns/get-by-id"},{"title":"Create Campaign","api":"POST https://server.smartlead.ai/api/v1/campaigns/create","href":"/api-reference/campaigns/create"},{"title":"Update Campaign Status","api":"POST https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/status","href":"/api-reference/campaigns/update-status"},{"title":"Update Campaign Settings","api":"POST https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/settings","href":"/api-reference/campaigns/update-settings"},{"title":"Update Campaign Schedule","api":"POST https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/schedule","href":"/api-reference/campaigns/update-schedule"},{"title":"Duplicate Campaign","api":"POST https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/duplicate","href":"/api-reference/campaigns/duplicate"},{"title":"Delete Campaign","api":"DELETE https://server.smartlead.ai/api/v1/campaigns/{campaign_id}","href":"/api-reference/campaigns/delete"},{"title":"Get Campaign Sequences","api":"GET https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/sequences","href":"/api-reference/campaigns/get-sequences"},{"title":"Update Campaign Sequences","api":"POST https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/sequences","href":"/api-reference/campaigns/update-sequences"},{"title":"Get Campaign Email Accounts","api":"GET https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/email-accounts","href":"/api-reference/campaigns/get-email-accounts"},{"title":"Add Email Accounts to Campaign","api":"POST https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/email-accounts","href":"/api-reference/campaigns/add-email-accounts"},{"title":"Add Email Accounts to Campaign by Tag","api":"POST https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/email-accounts/by-tag","href":"/api-reference/campaigns/add-email-accounts-by-tag"},{"title":"Remove Email Accounts from Campaign","api":"DELETE https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/email-accounts","href":"/api-reference/campaigns/remove-email-accounts"},{"title":"Reallocate Mailboxes","api":"POST https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/reallocate-mailboxes","href":"/api-reference/campaigns/reallocate-mailboxes"},{"title":"Add Tags to Campaigns","api":"POST https://server.smartlead.ai/api/v1/campaigns/tags","href":"/api-reference/campaigns/add-tags"},{"title":"Remove Tags from Campaigns","api":"DELETE https://server.smartlead.ai/api/v1/campaigns/tags","href":"/api-reference/campaigns/remove-tags"},{"title":"Create Subsequence Campaign","api":"POST https://server.smartlead.ai/api/v1/campaigns/create-subsequence","href":"/api-reference/campaigns/create-subsequence"},{"title":"Forward Campaign Email","api":"POST https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/forward-email","href":"/api-reference/campaigns/forward-email"},{"title":"Reply to Campaign Lead","api":"POST https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/reply-email-thread","href":"/api-reference/campaigns/reply-email-thread"},{"title":"Send Test Email","api":"POST https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/send-test-email","href":"/api-reference/campaigns/send-test-email"},{"title":"Update Campaign Team Member","api":"POST https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/team-member","href":"/api-reference/campaigns/update-team-member"},{"title":"Move Campaigns to Folder","api":"POST https://server.smartlead.ai/api/v1/campaigns/update-folder","href":"/api-reference/campaigns/update-folder"},{"title":"Assign Client to Campaign","api":"POST https://server.smartlead.ai/api/v1/campaigns/assign-client","href":"/api-reference/campaigns/assign-client"},{"title":"Update Spintax Distribution Mode","api":"POST https://server.smartlead.ai/api/v1/campaigns/spintax-distribution-mode","href":"/api-reference/campaigns/update-spintax-distribution"},{"title":"Get Campaign AI Prompt Template","api":"GET https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/prompt-template","href":"/api-reference/campaigns/get-prompt-template"},{"title":"Create Campaign AI Prompt Template","api":"POST https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/prompt-template","href":"/api-reference/campaigns/create-prompt-template"},{"title":"Update Campaign AI Prompt Template","api":"PATCH https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/prompt-template/{template_id}","href":"/api-reference/campaigns/update-prompt-template"}]},{"group":"Campaign Leads","pages":[{"title":"Add Leads to Campaign","api":"POST https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/leads","href":"/api-reference/campaigns/add-leads"},{"title":"Get Campaign Leads","api":"GET https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/leads","href":"/api-reference/campaigns/get-leads"},{"title":"Get Lead by ID","api":"GET https://server.smartlead.ai/api/v1/leads/{lead_id}","href":"/api-reference/campaigns/get-lead-by-id"},{"title":"Get Lead Message History","api":"GET https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/leads/{lead_id}/message-history","href":"/api-reference/campaigns/get-lead-history"},{"title":"Get Bulk Lead Message History","api":"POST https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/message-history-for-leads/bbfbdsFGHlBr76ruhjvh6fhHL","href":"/api-reference/campaigns/get-leads-history-bulk"},{"title":"Get All Leads Activities","api":"GET https://server.smartlead.ai/api/v1/campaigns/all-leads-activities","href":"/api-reference/campaigns/all-leads-activities"},{"title":"Update Campaign Lead Details","api":"POST https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/leads/{lead_id}/","href":"/api-reference/campaigns/update-lead"},{"title":"Update Lead Category in Campaign","api":"POST https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/leads/{lead_id}/category","href":"/api-reference/campaigns/update-lead-category"},{"title":"Update Lead Email Account","api":"POST https://server.smartlead.ai/api/v1/campaigns/update-lead-email-account","href":"/api-reference/campaigns/update-lead-email-account"},{"title":"Pause Campaign Lead","api":"POST https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/leads/{lead_id}/pause","href":"/api-reference/campaigns/pause-lead"},{"title":"Resume Campaign Lead","api":"POST https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/leads/{lead_id}/resume","href":"/api-reference/campaigns/resume-lead"},{"title":"Mark Lead as Complete","api":"POST https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/leads/{lead_map_id}/manual-complete","href":"/api-reference/campaigns/mark-lead-complete"},{"title":"Unsubscribe Lead from Campaign","api":"POST https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/leads/{lead_id}/unsubscribe","href":"/api-reference/campaigns/unsubscribe-lead"},{"title":"Delete Lead from Campaign","api":"DELETE https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/leads/{lead_id}","href":"/api-reference/campaigns/delete-lead"},{"title":"Export Campaign Leads","api":"GET https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/leads-export","href":"/api-reference/campaigns/export-leads"},{"title":"Search Campaign Leads","api":"POST https://server.smartlead.ai/api/v1/campaigns/{campaignId}/leads/filter","href":"/api-reference/campaigns/search-leads"}]},{"group":"Campaign Webhooks","pages":[{"title":"Get Campaign Webhooks","api":"GET https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/webhooks","href":"/api-reference/campaigns/get-webhooks"},{"title":"Get Webhook Summary","api":"GET https://server.smartlead.ai/api/v1/campaigns/{campaignId}/webhooks/summary","href":"/api-reference/campaigns/get-webhook-summary"},{"title":"Create/Update Campaign Webhook","api":"POST https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/webhooks","href":"/api-reference/campaigns/save-webhooks"},{"title":"Delete Campaign Webhook","api":"DELETE https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/webhooks/{webhook_id}","href":"/api-reference/campaigns/delete-webhook"},{"title":"Retrigger Campaign Webhooks","api":"POST https://server.smartlead.ai/api/v1/campaigns/{campaignId}/webhooks/retrigger-failed-events","href":"/api-reference/campaigns/retrigger-webhooks"}]},{"group":"Campaign Statistics","pages":[{"title":"Get Campaign Statistics","api":"GET https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/statistics","href":"/api-reference/campaigns/statistics"},{"title":"Fetch Campaign Statistics by Campaign ID","api":"GET https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/statistics","href":"/api-reference/campaign-statistics/get-by-id"},{"title":"Fetch Campaign Sequence Analytics","api":"GET https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/sequence-analytics","href":"/api-reference/campaign-statistics/sequence-analytics"},{"title":"Fetch Campaign Statistics by Date Range","api":"GET https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/analytics-by-date","href":"/api-reference/campaign-statistics/get-by-date-range"},{"title":"Fetch Campaign Top Level Analytics","api":"GET https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/analytics","href":"/api-reference/campaign-statistics/top-level"},{"title":"Fetch Campaign Top Level Analytics by Date Range","api":"GET https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/top-level-analytics-by-date","href":"/api-reference/campaign-statistics/top-level-by-date"},{"title":"Fetch Campaign Lead Statistics","api":"GET https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/leads-statistics","href":"/api-reference/campaign-statistics/lead-statistics"},{"title":"Fetch Campaign Mailbox Statistics","api":"GET https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/mailbox-statistics","href":"/api-reference/campaign-statistics/mailbox-statistics"},{"title":"Get Campaign Analytics","api":"GET https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/analytics","href":"/api-reference/campaigns/get-analytics"},{"title":"Get Campaign Analytics by Date Range","api":"GET https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/analytics-by-date","href":"/api-reference/campaigns/get-analytics-by-date"},{"title":"Get Top Level Analytics by Date","api":"GET https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/top-level-analytics-by-date","href":"/api-reference/campaigns/get-top-level-analytics"}]},{"group":"Lead Management","pages":[{"title":"Get Lead by Email","api":"GET https://server.smartlead.ai/api/v1/leads/","href":"/api-reference/leads/get-by-email"},{"title":"Get Campaign Leads","api":"GET https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/leads","href":"/api-reference/leads/get-by-campaign"},{"title":"Add Leads to Campaign","api":"POST https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/leads","href":"/api-reference/leads/add-to-campaign"},{"title":"Update Lead","api":"POST https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/leads/{lead_id}/","href":"/api-reference/leads/update"},{"title":"Delete Lead from Campaign","api":"DELETE https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/leads/{lead_id}","href":"/api-reference/leads/delete"},{"title":"Pause Lead","api":"POST https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/leads/{lead_id}/pause","href":"/api-reference/leads/pause"},{"title":"Resume Lead","api":"POST https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/leads/{lead_id}/resume","href":"/api-reference/leads/resume"},{"title":"Unsubscribe Lead Globally","api":"POST https://server.smartlead.ai/api/v1/leads/{lead_id}/unsubscribe","href":"/api-reference/leads/unsubscribe"},{"title":"Get All Leads Activities","api":"GET https://server.smartlead.ai/api/v1/campaigns/all-leads-activities","href":"/api-reference/leads/activities"},{"title":"Export Campaign Leads","api":"GET https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/leads-export","href":"/api-reference/leads/export"},{"title":"Get Lead Campaign Overview","api":"GET https://server.smartlead.ai/api/v1/leads/{leadId}/campaign-overview","href":"/api-reference/leads/campaign-overview"},{"title":"Get Lead Sequence Details","api":"GET https://server.smartlead.ai/api/v1/leads/{leadMapId}/sequence-details","href":"/api-reference/leads/sequence-details"}]},{"group":"Lead Categories","pages":[{"title":"Get Lead Categories","api":"GET https://server.smartlead.ai/api/v1/leads/fetch-categories","href":"/api-reference/leads/categories"},{"title":"Create Lead Category","api":"POST https://server.smartlead.ai/api/v1/leads/categories","href":"/api-reference/leads/create-category"},{"title":"Update Lead Category","api":"PATCH https://server.smartlead.ai/api/v1/leads/categories/{category_id}","href":"/api-reference/leads/update-category"},{"title":"Delete Lead Category","api":"DELETE https://server.smartlead.ai/api/v1/leads/categories/{category_id}","href":"/api-reference/leads/delete-category"}]},{"group":"Lead Notes","pages":[{"title":"Create Lead Note","api":"POST https://server.smartlead.ai/api/v1/master-inbox/create-note","href":"/api-reference/lead-notes/create"},{"title":"Get Lead Notes","api":"GET https://server.smartlead.ai/api/v1/crm/leads/notes/{id}","href":"/api-reference/lead-notes/get-all"}]},{"group":"Lead Tasks","pages":[{"title":"Create Lead Task","api":"POST https://server.smartlead.ai/api/v1/master-inbox/create-task","href":"/api-reference/lead-tasks/create"},{"title":"Get Lead Tasks","api":"GET https://server.smartlead.ai/api/v1/crm/leads/tasks/{id}","href":"/api-reference/lead-tasks/get-all"}]},{"group":"Lead Tags","pages":[{"title":"Create Tag","api":"POST https://server.smartlead.ai/api/v1/email-accounts/tag-manager","href":"/api-reference/lead-tags/create"},{"title":"Get Lead Tags","api":"GET https://server.smartlead.ai/api/v1/crm/leads/tags","href":"/api-reference/lead-tags/get-all"},{"title":"Add Tags to Lead","api":"POST https://server.smartlead.ai/api/v1/crm/leads/tags","href":"/api-reference/lead-tags/add-to-lead"},{"title":"Remove Tag from Lead","api":"DELETE https://server.smartlead.ai/api/v1/crm/leads/tags/{tagMappingId}","href":"/api-reference/lead-tags/remove-from-lead"}]},{"group":"Lead Lists","pages":[{"title":"Create Lead List","api":"POST https://server.smartlead.ai/api/v1/lead-list/","href":"/api-reference/lead-lists/create"},{"title":"Get All Lead Lists","api":"GET https://server.smartlead.ai/api/v1/lead-list/","href":"/api-reference/lead-lists/get-all"},{"title":"Get Lead List by ID","api":"GET https://server.smartlead.ai/api/v1/lead-list/{id}","href":"/api-reference/lead-lists/get-by-id"},{"title":"Update Lead List","api":"PUT https://server.smartlead.ai/api/v1/lead-list/{id}","href":"/api-reference/lead-lists/update"},{"title":"Delete Lead List","api":"DELETE https://server.smartlead.ai/api/v1/lead-list/{id}","href":"/api-reference/lead-lists/delete"},{"title":"Import Leads to List","api":"POST https://server.smartlead.ai/api/v1/lead-list/{id}/import","href":"/api-reference/lead-lists/import-leads"},{"title":"Move Leads Between Lists","api":"POST https://server.smartlead.ai/api/v1/leads/leads/push-between-lists","href":"/api-reference/lead-lists/push-between-lists"},{"title":"Push Leads to Campaign","api":"POST https://server.smartlead.ai/api/v1/leads/push-to-campaign","href":"/api-reference/lead-lists/push-to-campaign"},{"title":"Assign Tags to Lead Lists","api":"POST https://server.smartlead.ai/api/v1/lead-list/assign-tags","href":"/api-reference/lead-lists/assign-tags"}]},{"group":"Email Account Management","pages":[{"title":"Get All Email Accounts","api":"GET https://server.smartlead.ai/api/v1/email-accounts/","href":"/api-reference/email-accounts/get-all"},{"title":"Get Email Account by ID","api":"GET https://server.smartlead.ai/api/v1/email-accounts/{email_account_id}/","href":"/api-reference/email-accounts/get-by-id"},{"title":"Get Email Account by Email Address","api":"GET https://server.smartlead.ai/api/v1/email-accounts/fetch-email-account-details","href":"/api-reference/email-accounts/get-by-email"},{"title":"Add SMTP Email Account","api":"POST https://server.smartlead.ai/api/v1/email-accounts/save","href":"/api-reference/email-accounts/add-smtp"},{"title":"Add OAuth Email Account","api":"POST https://server.smartlead.ai/api/v1/email-accounts/save-oauth","href":"/api-reference/email-accounts/add-oauth"},{"title":"Update Email Account","api":"POST https://server.smartlead.ai/api/v1/email-accounts/{email_account_id}","href":"/api-reference/email-accounts/update"},{"title":"Delete Email Account","api":"DELETE https://server.smartlead.ai/api/v1/email-accounts/{email_account_id}","href":"/api-reference/email-accounts/delete"},{"title":"Update Warmup Settings","api":"POST https://server.smartlead.ai/api/v1/email-accounts/{email_account_id}/warmup","href":"/api-reference/email-accounts/warmup-settings"},{"title":"Get Warmup Statistics","api":"GET https://server.smartlead.ai/api/v1/email-accounts/{email_account_id}/warmup-stats","href":"/api-reference/email-accounts/warmup-stats"},{"title":"Suspend Email Account","api":"PUT https://server.smartlead.ai/api/v1/email-accounts/suspend/{email_account_id}","href":"/api-reference/email-accounts/suspend"},{"title":"Unsuspend Email Account","api":"DELETE https://server.smartlead.ai/api/v1/email-accounts/unsuspend/{email_account_id}","href":"/api-reference/email-accounts/unsuspend"},{"title":"Bulk Update Email Account Config","api":"POST https://server.smartlead.ai/api/v1/email-accounts/bulk-update-email-account-config","href":"/api-reference/email-accounts/bulk-update-config"},{"title":"Reconnect Failed Email Accounts","api":"POST https://server.smartlead.ai/api/v1/email-accounts/reconnect-failed-email-accounts","href":"/api-reference/email-accounts/reconnect-failed"},{"title":"Send Warmup Unblock OTP","api":"POST https://server.smartlead.ai/api/v1/email-accounts/{account_id}/send-otp-email","href":"/api-reference/email-accounts/send-warmup-unblock-otp"},{"title":"Verify Warmup Unblock OTP","api":"POST https://server.smartlead.ai/api/v1/email-accounts/{account_id}/verify-otp","href":"/api-reference/email-accounts/verify-warmup-unblock-otp"}]},{"group":"Email Account Tags","pages":[{"title":"Get All Tags","api":"GET https://server.smartlead.ai/api/v1/email-accounts/tags","href":"/api-reference/email-accounts/tags"},{"title":"Create Tag","api":"POST https://server.smartlead.ai/api/v1/tags","href":"/api-reference/email-account-tags/create-new"},{"title":"Update Email Account Tag","api":"POST https://server.smartlead.ai/api/v1/email-accounts/tag-manager","href":"/api-reference/email-account-tags/create"},{"title":"Get Email Account Tags","api":"POST https://server.smartlead.ai/api/v1/email-accounts/tag-list","href":"/api-reference/email-account-tags/get-all"},{"title":"Assign Tags to Email Accounts","api":"POST https://server.smartlead.ai/api/v1/email-accounts/tag-mapping","href":"/api-reference/email-account-tags/assign"},{"title":"Remove Tags from Email Accounts","api":"DELETE https://server.smartlead.ai/api/v1/email-accounts/tag-mapping","href":"/api-reference/email-account-tags/remove"}]},{"group":"Master Inbox","pages":[{"title":"Get Inbox Replies","api":"POST https://server.smartlead.ai/api/v1/master-inbox/inbox-replies","href":"/api-reference/inbox/get-messages"},{"title":"Get Sent Emails","api":"POST https://server.smartlead.ai/api/v1/master-inbox/sent","href":"/api-reference/inbox/get-sent"},{"title":"Get Assigned to Me","api":"POST https://server.smartlead.ai/api/v1/master-inbox/assigned-me","href":"/api-reference/inbox/get-assigned"},{"title":"Get Unread Replies","api":"POST https://server.smartlead.ai/api/v1/master-inbox/unread-replies","href":"/api-reference/inbox/get-unread"},{"title":"Get Important Emails","api":"POST https://server.smartlead.ai/api/v1/master-inbox/important","href":"/api-reference/inbox/get-important"},{"title":"Get Snoozed Emails","api":"POST https://server.smartlead.ai/api/v1/master-inbox/snoozed","href":"/api-reference/inbox/get-snoozed"},{"title":"Get Scheduled Emails","api":"POST https://server.smartlead.ai/api/v1/master-inbox/scheduled","href":"/api-reference/inbox/get-scheduled"},{"title":"Get Reminder Emails","api":"POST https://server.smartlead.ai/api/v1/master-inbox/reminders","href":"/api-reference/inbox/get-reminders"},{"title":"Get Archived Emails","api":"POST https://server.smartlead.ai/api/v1/master-inbox/archived","href":"/api-reference/inbox/get-archived"},{"title":"Get Custom View Emails","api":"POST https://server.smartlead.ai/api/v1/master-inbox/views","href":"/api-reference/inbox/get-views"},{"title":"Get Inbox Item by ID","api":"GET https://server.smartlead.ai/api/v1/master-inbox/{id}","href":"/api-reference/inbox/get-by-id"},{"title":"Get Untracked Replies","api":"GET https://server.smartlead.ai/api/v1/master-inbox/untracked-replies","href":"/api-reference/inbox/get-untracked"},{"title":"Reply to Email","api":"POST https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/reply-email-thread","href":"/api-reference/inbox/reply"},{"title":"Get Reply Status","api":"GET https://server.smartlead.ai/api/v1/master-inbox/reply-status","href":"/api-reference/inbox/reply-status"},{"title":"Forward Email","api":"POST https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/forward-email","href":"/api-reference/inbox/forward"},{"title":"Change Read Status","api":"PATCH https://server.smartlead.ai/api/v1/master-inbox/change-read-status","href":"/api-reference/inbox/mark-read"},{"title":"Update Lead Category","api":"PATCH https://server.smartlead.ai/api/v1/master-inbox/update-category","href":"/api-reference/inbox/update-category"},{"title":"Update Lead Revenue","api":"PATCH https://server.smartlead.ai/api/v1/master-inbox/update-revenue","href":"/api-reference/inbox/update-revenue"},{"title":"Assign Team Member","api":"POST https://server.smartlead.ai/api/v1/master-inbox/update-team-member","href":"/api-reference/inbox/update-team-member"},{"title":"Create Lead Task","api":"POST https://server.smartlead.ai/api/v1/master-inbox/create-task","href":"/api-reference/inbox/create-task"},{"title":"Create Lead Note","api":"POST https://server.smartlead.ai/api/v1/master-inbox/create-note","href":"/api-reference/inbox/create-note"},{"title":"Block Email Domains","api":"POST https://server.smartlead.ai/api/v1/master-inbox/block-domains","href":"/api-reference/inbox/block-domains"},{"title":"Resume Paused Lead","api":"PATCH https://server.smartlead.ai/api/v1/master-inbox/resume-lead","href":"/api-reference/inbox/resume-lead"},{"title":"Set Lead Reminder","api":"POST https://server.smartlead.ai/api/v1/master-inbox/set-reminder","href":"/api-reference/inbox/set-reminder"},{"title":"Push Lead to Subsequence","api":"POST https://server.smartlead.ai/api/v1/master-inbox/push-to-subsequence","href":"/api-reference/inbox/push-to-subsequence"},{"title":"Create Saved View","api":"POST https://server.smartlead.ai/api/v1/master-inbox/saved-views","href":"/api-reference/inbox/create-saved-view"},{"title":"Ignore Reply","api":"PATCH https://server.smartlead.ai/api/v1/master-inbox/ignore-reply","href":"/api-reference/inbox/ignore-reply"},{"title":"Associate Untracked Reply to Lead","api":"POST https://server.smartlead.ai/api/v1/master-inbox/untracked-replies/associate-to-lead","href":"/api-reference/inbox/associate-untracked-reply"}]},{"group":"Smart Delivery","pages":[{"title":"Get Provider IDs","api":"GET https://smartdelivery.smartlead.ai/api/v1/spam-test/seed/providers","href":"/api-reference/smart-delivery/provider-ids"},{"title":"Create Manual Placement Test","api":"POST https://smartdelivery.smartlead.ai/api/v1/spam-test/manual","href":"/api-reference/smart-delivery/create-manual-test"},{"title":"Create Automated Placement Test","api":"POST https://smartdelivery.smartlead.ai/api/v1/spam-test/schedule","href":"/api-reference/smart-delivery/create-automated-test"},{"title":"Get Spam Test Details","api":"GET https://smartdelivery.smartlead.ai/api/v1/spam-test/{spamTestId}","href":"/api-reference/smart-delivery/test-details"},{"title":"Delete Tests in Bulk","api":"POST https://smartdelivery.smartlead.ai/api/v1/spam-test/delete","href":"/api-reference/smart-delivery/delete-tests-bulk"},{"title":"Stop Automated Test","api":"PUT https://smartdelivery.smartlead.ai/api/v1/spam-test/{spamTestId}/stop","href":"/api-reference/smart-delivery/stop-automated-test"},{"title":"List All Tests","api":"POST https://smartdelivery.smartlead.ai/api/v1/spam-test/report","href":"/api-reference/smart-delivery/list-tests"},{"title":"Provider-wise Report","api":"POST https://smartdelivery.smartlead.ai/api/v1/spam-test/report/{spamTestId}/providerwise","href":"/api-reference/smart-delivery/provider-report"},{"title":"Geo-wise Report","api":"POST https://smartdelivery.smartlead.ai/api/v1/spam-test/report/{spamTestId}/groupwise","href":"/api-reference/smart-delivery/geo-report"},{"title":"Sender Account Report","api":"GET https://smartdelivery.smartlead.ai/api/v1/spam-test/report/{spamTestId}/sender-account-wise","href":"/api-reference/smart-delivery/sender-report"},{"title":"Spam Filter Report","api":"GET https://smartdelivery.smartlead.ai/api/v1/spam-test/report/{spamTestId}/spam-filter-details","href":"/api-reference/smart-delivery/spam-filter-report"},{"title":"DKIM Details","api":"GET https://smartdelivery.smartlead.ai/api/v1/spam-test/report/{spamTestId}/dkim-details","href":"/api-reference/smart-delivery/dkim-details"},{"title":"SPF Details","api":"GET https://smartdelivery.smartlead.ai/api/v1/spam-test/report/{spamTestId}/spf-details","href":"/api-reference/smart-delivery/spf-details"},{"title":"rDNS Report","api":"GET https://smartdelivery.smartlead.ai/api/v1/spam-test/report/{spamTestId}/rdns-details","href":"/api-reference/smart-delivery/rdns-report"},{"title":"Sender Account List","api":"GET https://smartdelivery.smartlead.ai/api/v1/spam-test/report/{spamTestId}/sender-accounts","href":"/api-reference/smart-delivery/sender-list"},{"title":"IP Blacklist Check","api":"GET https://smartdelivery.smartlead.ai/api/v1/spam-test/report/{spamTestId}/blacklist","href":"/api-reference/smart-delivery/blacklists"},{"title":"Domain Blacklist","api":"GET https://smartdelivery.smartlead.ai/api/v1/spam-test/report/{spamTestId}/domain-blacklist","href":"/api-reference/smart-delivery/domain-blacklist"},{"title":"Test Email Content","api":"GET https://smartdelivery.smartlead.ai/api/v1/spam-test/report/{spamTestId}/email-content","href":"/api-reference/smart-delivery/test-email-content"},{"title":"IP Blacklist Count","api":"GET https://smartdelivery.smartlead.ai/api/v1/spam-test/report/{spamTestId}/blacklist","href":"/api-reference/smart-delivery/ip-blacklist-count"},{"title":"Email Reply Headers","api":"GET https://smartdelivery.smartlead.ai/api/v1/spam-test/report/{spamTestId}/sender-account-wise/{replyId}/email-headers","href":"/api-reference/smart-delivery/reply-headers"},{"title":"Schedule History","api":"GET https://smartdelivery.smartlead.ai/api/v1/spam-test/report/{spamTestId}/schedule-history","href":"/api-reference/smart-delivery/schedule-history"},{"title":"IP Details","api":"GET https://smartdelivery.smartlead.ai/api/v1/spam-test/report/{spamTestId}/ip-analytics","href":"/api-reference/smart-delivery/ip-details"},{"title":"Mailbox Summary","api":"GET https://smartdelivery.smartlead.ai/api/v1/spam-test/report/mailboxes-summary","href":"/api-reference/smart-delivery/mailbox-summary"},{"title":"Mailbox Count","api":"GET https://smartdelivery.smartlead.ai/api/v1/spam-test/report/mailboxes-count","href":"/api-reference/smart-delivery/mailbox-count"},{"title":"Get All Folders","api":"GET https://smartdelivery.smartlead.ai/api/v1/spam-test/folder","href":"/api-reference/smart-delivery/get-folders"},{"title":"Create Folder","api":"POST https://smartdelivery.smartlead.ai/api/v1/spam-test/folder","href":"/api-reference/smart-delivery/create-folder"},{"title":"Get Folder by ID","api":"GET https://smartdelivery.smartlead.ai/api/v1/spam-test/folder/{folderId}","href":"/api-reference/smart-delivery/get-folder-by-id"},{"title":"Delete Folder","api":"DELETE https://smartdelivery.smartlead.ai/api/v1/spam-test/folder/{folderId}","href":"/api-reference/smart-delivery/delete-folder"}]},{"group":"Smart Senders","pages":[{"title":"Get OTP for Admin Mailbox","api":"GET https://smart-senders.smartlead.ai/api/v1/smart-senders/auth-secret","href":"/api-reference/smart-senders/get-otp"},{"title":"Auto Generate Mailboxes","api":"POST https://smart-senders.smartlead.ai/api/v1/smart-senders/auto-generate-mailboxes","href":"/api-reference/smart-senders/auto-generate"},{"title":"Search Domain","api":"GET https://smart-senders.smartlead.ai/api/v1/smart-senders/search-domain","href":"/api-reference/smart-senders/search-domain"},{"title":"Get Vendors","api":"GET https://smart-senders.smartlead.ai/api/v1/smart-senders/get-vendors","href":"/api-reference/smart-senders/get-vendors"},{"title":"Place Order","api":"POST https://smart-senders.smartlead.ai/api/v1/smart-senders/place-order","description":"Place an order to purchase domains and provision mailboxes through a Smart Senders vendor","href":"/api-reference/smart-senders/place-order"},{"title":"Add Mailboxes to Domain","api":"POST https://smart-senders.smartlead.ai/api/v1/smart-senders/add-mailboxes-to-domain","href":"/api-reference/smart-senders/add-mailboxes"},{"title":"Get Purchased Domain List","api":"GET https://smart-senders.smartlead.ai/api/v1/smart-senders/get-domain-list","description":"Get the list of domains purchased through Smart Senders","href":"/api-reference/smart-senders/domain-list"},{"title":"Get Order Details","api":"GET https://smart-senders.smartlead.ai/api/v1/smart-senders/order-details","href":"/api-reference/smart-senders/order-details"}]},{"group":"Smart Servers","pages":[{"title":"List SmartServers","api":"GET https://smartservers.smartlead.ai/api/v1/smart-server/","href":"/api-reference/smart-servers/list-servers"},{"title":"Assign SmartInfra to Campaigns","api":"POST https://smartservers.smartlead.ai/api/v1/smart-infra/mapping","href":"/api-reference/smart-servers/assign-campaigns"},{"title":"Get SmartServers for a Campaign","api":"GET https://smartservers.smartlead.ai/api/v1/smart-server/all/campaign/{campaign_id}","href":"/api-reference/smart-servers/get-campaign-servers"},{"title":"Unassign SmartServers from Campaign","api":"DELETE https://smartservers.smartlead.ai/api/v1/smart-server/mapping/campaign/{campaign_id}","href":"/api-reference/smart-servers/unassign-campaign"}]},{"group":"Webhooks","pages":[{"title":"Create Webhook","api":"POST https://server.smartlead.ai/api/v1/webhook/create","href":"/api-reference/webhooks/create"},{"title":"Get Webhook","api":"GET https://server.smartlead.ai/api/v1/webhook/{webhook_id}","href":"/api-reference/webhooks/get"},{"title":"Update Webhook","api":"PUT https://server.smartlead.ai/api/v1/webhook/update/:webhook_id","href":"/api-reference/webhooks/update"},{"title":"Delete Campaign Webhook","api":"DELETE https://server.smartlead.ai/api/v1/webhook/delete","href":"/api-reference/webhooks/delete"},{"title":"Webhook Events Reference","href":"/api-reference/webhooks/events"}]},{"group":"Global Analytics","pages":[{"title":"How Analytics Metrics Are Calculated","href":"/api-reference/analytics/how-metrics-are-calculated"},{"title":"Get Overall Analytics","api":"GET https://server.smartlead.ai/api/v1/analytics/overall-stats-v2","href":"/api-reference/analytics/overview"},{"title":"Get Campaign List","api":"GET https://server.smartlead.ai/api/v1/analytics/campaign/list","href":"/api-reference/analytics/campaign-list"},{"title":"Get Client List","api":"GET https://server.smartlead.ai/api/v1/analytics/client/list","href":"/api-reference/analytics/client-list"},{"title":"Get Month-wise Client Count","api":"GET https://server.smartlead.ai/api/v1/analytics/client/month-wise-count","href":"/api-reference/analytics/month-wise-client-count"},{"title":"Get Day-wise Overall Stats","api":"GET https://server.smartlead.ai/api/v1/analytics/day-wise-overall-stats","href":"/api-reference/analytics/day-wise-stats"},{"title":"Day-wise Stats by Sent Time","api":"GET https://server.smartlead.ai/api/v1/analytics/day-wise-overall-stats-by-sent-time","href":"/api-reference/analytics/day-wise-sent-time"},{"title":"Day-wise Positive Reply Stats","api":"GET https://server.smartlead.ai/api/v1/analytics/day-wise-positive-reply-stats","href":"/api-reference/analytics/day-wise-positive-reply"},{"title":"Positive Reply Stats by Sent Time","api":"GET https://server.smartlead.ai/api/v1/analytics/day-wise-positive-reply-stats-by-sent-time","href":"/api-reference/analytics/day-wise-positive-sent-time"},{"title":"Campaign Performance","api":"GET https://server.smartlead.ai/api/v1/analytics/campaign/overall-stats","href":"/api-reference/analytics/campaign-performance"},{"title":"Client Overall Stats","api":"GET https://server.smartlead.ai/api/v1/analytics/client/overall-stats","href":"/api-reference/analytics/client-performance"},{"title":"Email-ID-wise Health Metrics","api":"GET https://server.smartlead.ai/api/v1/analytics/mailbox/name-wise-health-metrics","href":"/api-reference/analytics/email-wise-health"},{"title":"Domain-wise Health Metrics","api":"GET https://server.smartlead.ai/api/v1/analytics/mailbox/domain-wise-health-metrics","href":"/api-reference/analytics/domain-wise-health"},{"title":"Mailbox Overall Stats","api":"GET https://server.smartlead.ai/api/v1/analytics/mailbox/overall-stats","href":"/api-reference/analytics/mailbox-health"},{"title":"Provider-wise Performance","api":"GET https://server.smartlead.ai/api/v1/analytics/mailbox/provider-wise-overall-performance","href":"/api-reference/analytics/provider-performance"},{"title":"Team Board Stats","api":"GET https://server.smartlead.ai/api/v1/analytics/team-board/overall-stats","href":"/api-reference/analytics/team-board-stats"},{"title":"Lead Statistics","api":"GET https://server.smartlead.ai/api/v1/analytics/lead/overall-stats","href":"/api-reference/analytics/lead-stats"},{"title":"Lead Category-wise Response","api":"GET https://server.smartlead.ai/api/v1/analytics/lead/category-wise-response","href":"/api-reference/analytics/lead-category-response"},{"title":"Leads Take for First Reply","api":"GET https://server.smartlead.ai/api/v1/analytics/campaign/leads-take-for-first-reply","href":"/api-reference/analytics/leads-for-first-reply"},{"title":"Follow-up Reply Rate","api":"GET https://server.smartlead.ai/api/v1/analytics/campaign/follow-up-reply-rate","href":"/api-reference/analytics/followup-reply-rate"},{"title":"Lead to Reply Time","api":"GET https://server.smartlead.ai/api/v1/analytics/campaign/lead-to-reply-time","href":"/api-reference/analytics/lead-to-reply-time"},{"title":"Campaign Response Stats","api":"GET https://server.smartlead.ai/api/v1/analytics/campaign/response-stats","href":"/api-reference/analytics/campaign-response-stats"},{"title":"Campaign Status Stats","api":"GET https://server.smartlead.ai/api/v1/analytics/campaign/status-stats","href":"/api-reference/analytics/campaign-status-stats"}]},{"group":"Utilities","pages":[{"title":"Send Single Email","api":"POST https://server.smartlead.ai/api/v1/send-email/initiate","href":"/api-reference/utilities/send-single-email"},{"title":"Domain Block List Management","href":"/api-reference/utilities/domain-block-list"}]},{"group":"Client Management","pages":[{"title":"Create Client","api":"POST https://server.smartlead.ai/api/v1/client/save","href":"/api-reference/clients/create"},{"title":"Get All Clients","api":"GET https://server.smartlead.ai/api/v1/client/","href":"/api-reference/clients/get-all"},{"title":"Update Client","api":"POST https://server.smartlead.ai/api/v1/client/save","href":"/api-reference/clients/update"},{"title":"Manage Client API Keys","api":"POST https://server.smartlead.ai/api/v1/client/api-key","href":"/api-reference/clients/api-keys"},{"title":"Get Client by ID","api":"GET https://server.smartlead.ai/api/v1/client/{id}","href":"/api-reference/clients/get-by-id"},{"title":"Add Client Code Snippet","api":"POST https://server.smartlead.ai/api/v1/client/{client_id}/code-integrations","href":"/api-reference/clients/create-code-integration"},{"title":"Delete Client","api":"DELETE https://server.smartlead.ai/api/v1/client/{id}","href":"/api-reference/clients/delete"}]},{"group":"Smart Prospect","pages":[{"title":"Search Contacts API","api":"POST https://prospect-api.smartlead.ai/api/v1/search-email-leads/search-contacts","href":"/api-reference/smart-prospect/search-contacts"},{"title":"Get Contacts API","api":"POST https://prospect-api.smartlead.ai/api/v1/search-email-leads/get-contacts","href":"/api-reference/smart-prospect/get-contacts"},{"title":"Fetch Contacts API","api":"POST https://prospect-api.smartlead.ai/api/v1/search-email-leads/fetch-contacts","href":"/api-reference/smart-prospect/fetch-contacts"},{"title":"Find Emails API","api":"POST https://prospect-api.smartlead.ai/api/v1/search-email-leads/search-contacts/find-emails","href":"/api-reference/smart-prospect/find-emails"},{"title":"Review Contacts API","api":"PATCH https://prospect-api.smartlead.ai/api/v1/search-email-leads/review-contacts/{filter_id}","href":"/api-reference/smart-prospect/review-contacts"},{"title":"Save Search API","api":"POST https://prospect-api.smartlead.ai/api/v1/search-email-leads/search-filters/save-search","href":"/api-reference/smart-prospect/save-search"},{"title":"Saved Searches API","api":"GET https://prospect-api.smartlead.ai/api/v1/search-email-leads/search-filters/saved-searches","href":"/api-reference/smart-prospect/saved-searches"},{"title":"Fetched Searches API","api":"GET https://prospect-api.smartlead.ai/api/v1/search-email-leads/search-filters/fetched-searches","href":"/api-reference/smart-prospect/fetched-searches"},{"title":"Recent Searches API","api":"GET https://prospect-api.smartlead.ai/api/v1/search-email-leads/search-filters/recent-searches","href":"/api-reference/smart-prospect/recent-searches"},{"title":"Update Saved Search API","api":"PUT https://prospect-api.smartlead.ai/api/v1/search-email-leads/search-filters/save-search/{id}","href":"/api-reference/smart-prospect/update-saved-search"},{"title":"Update Fetched Lead API","api":"PUT https://prospect-api.smartlead.ai/api/v1/search-email-leads/search-filters/fetched-searches/{id}","href":"/api-reference/smart-prospect/update-fetched-lead"},{"title":"Search Analytics API","api":"GET https://prospect-api.smartlead.ai/api/v1/search-email-leads/search-analytics","href":"/api-reference/smart-prospect/search-analytics"},{"title":"Reply Analytics API","api":"GET https://prospect-api.smartlead.ai/api/v1/search-email-leads/reply-analytics","href":"/api-reference/smart-prospect/reply-analytics"},{"title":"Cities API","api":"GET https://prospect-api.smartlead.ai/api/v1/search-email-leads/cities","href":"/api-reference/smart-prospect/cities"},{"title":"States API","api":"GET https://prospect-api.smartlead.ai/api/v1/search-email-leads/states","href":"/api-reference/smart-prospect/states"},{"title":"Countries API","api":"GET https://prospect-api.smartlead.ai/api/v1/search-email-leads/countries","href":"/api-reference/smart-prospect/countries"},{"title":"Company API","api":"GET https://prospect-api.smartlead.ai/api/v1/search-email-leads/company","href":"/api-reference/smart-prospect/company"},{"title":"Domain API","api":"GET https://prospect-api.smartlead.ai/api/v1/search-email-leads/domain","href":"/api-reference/smart-prospect/domain"},{"title":"Industries API","api":"GET https://prospect-api.smartlead.ai/api/v1/search-email-leads/industries","href":"/api-reference/smart-prospect/industries"},{"title":"Sub-Industries API","api":"GET https://prospect-api.smartlead.ai/api/v1/search-email-leads/sub-industries","href":"/api-reference/smart-prospect/sub-industries"},{"title":"Departments API","api":"GET https://prospect-api.smartlead.ai/api/v1/search-email-leads/departments","href":"/api-reference/smart-prospect/departments"},{"title":"Levels API","api":"GET https://prospect-api.smartlead.ai/api/v1/search-email-leads/levels","href":"/api-reference/smart-prospect/levels"},{"title":"Job Title API","api":"GET https://prospect-api.smartlead.ai/api/v1/search-email-leads/job-title","href":"/api-reference/smart-prospect/job-title"},{"title":"Head Counts API","api":"GET https://prospect-api.smartlead.ai/api/v1/search-email-leads/head-counts","href":"/api-reference/smart-prospect/head-counts"},{"title":"Revenue API","api":"GET https://prospect-api.smartlead.ai/api/v1/search-email-leads/revenue","href":"/api-reference/smart-prospect/revenue"},{"title":"Keywords API","api":"GET https://prospect-api.smartlead.ai/api/v1/search-email-leads/keywords","href":"/api-reference/smart-prospect/keywords"}]}]}]},"basePath":"","title":"Add Mailboxes to Domain - SmartLead API","buildId":"dpl_596ePT575z4qnAFksq1biRW97aLY","deploymentId":"dpl_596ePT575z4qnAFksq1biRW97aLY","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-C9Wu0MeN.js","utils-jWgu-6Qf.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DBD8f9qn.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BGuX1ui5.js","snippetPresets-Evy63nQB.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BQHO1lnV.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-B6C8m-t_.js","shallow-BG4cT0fH.js","getApiPlaygroundDisplay-CgEPrE-D.js","CodeSnippet-CU8JyZ9N.js","CodeSnippets-BnxHU32T.js","Page-D6S0Yh6q.js","getPastedJson-CwiYOonh.js","icon-DYDpWmDf.js","MethodPill-C-J-l7_c.js","DuplicateIcon-B6ARwg9w.js","createIcon-Dsv4MtDq.js","DynamicMarkdown-CtasenyM.js","SectionHeading-YNcgYwjB.js","axios-vUo_bRtp.js"]}