configure_byo_domain
Configure a custom domain for cold email sending: register domain, verify DNS, acknowledge consent, request managed mailboxes, or connect existing email accounts.
Instructions
Register or advance a BYO domain/mailbox intake (SPEC.md §20). action = register (needs domain + domainRelationship: fresh_standalone|subdomain_of_primary|is_primary — runs the pre-flight live-infra scan + abuse gate + reputation ladder, returns the starting byoStatus) | poll_dns (needs id — re-checks DNS delegation/records, advances pending_dns → active, or → abandoned after 7 idle days) | acknowledge_consent (needs id + acknowledged:true — REQUIRED before a primary domain can proceed past pending_consent; this does not remove your business's exposure, it documents informed consent) | request_managed_mailboxes (needs id + count — platform-provisioned mailboxes on an ALREADY-ACTIVE domain, the primary shape; every response carries a billing projection { provisionedAfter, projectedMonthlyCents, formula } — quoteOnly:true previews it without provisioning) | connect_mailbox (needs id + email + transport — declares an EXISTING OAuth/SMTP+IMAP connection you already have, bypassing provisioning; transport is { kind:'smtp', host, port, secure, user, pass } | { kind:'gmail_api', clientId, clientSecret, refreshToken } | { kind:'ms_graph', mode, tenantId, clientId, clientSecret, refreshToken? }).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Required for poll_dns/acknowledge_consent/request_managed_mailboxes/connect_mailbox — the domainId from register. | |
| count | No | Required for request_managed_mailboxes — how many platform-provisioned mailboxes to attach. | |
| No | Required for connect_mailbox — the existing mailbox address. | ||
| action | Yes | ||
| domain | No | Required for register. | |
| quoteOnly | No | Optional for request_managed_mailboxes — true previews the new mailbox count + projected monthly price WITHOUT provisioning (SPEC §18 quote-before-add). | |
| transport | No | Required for connect_mailbox — { kind: 'smtp', host, port, secure, user, pass } | { kind: 'gmail_api', clientId, clientSecret, refreshToken } | { kind: 'ms_graph', mode: 'delegated'|'app_only', tenantId, clientId, clientSecret, refreshToken? }. | |
| personaSlug | No | Optional for request_managed_mailboxes — defaults to a slug of the domain. | |
| acknowledged | No | Required (must be true) for acknowledge_consent — SPEC.md §20.4's separate, unbundled risk acknowledgment. | |
| domainRelationship | No | Required for register: fresh_standalone | subdomain_of_primary | is_primary. |