Freeze the exact setup and observed DNS into a pending domain.migrate approval. Does not provision resources. Only a signed-in administrator may authorize it through the Approvals panel; agent credentials and automatic review are rejected. Authorization atomically rechecks the DNS snapshot and prepares the approved domain.

post/v1/workspaces/{workspaceId}/sending-domain-migrations

Request

  • Base URL: https://api.bangermail.com
  • URL: https://api.bangermail.com/v1/workspaces/{workspaceId}/sending-domain-migrations
  • Auth: HTTP bearer

Headers

Idempotency-Keystring required

Request body

domainstring required

The product's exact domain or subdomain. By default Banger derives three separate lane subdomains.

setup_mode'simple' | 'advanced'

Simple provisions one mailbox transport for receiving and sending from selected mailbox addresses, including Broadcasts and Journeys. Advanced provisions separate sending lanes.

mailbox_mode'subdomain' | 'migrate'

Simple setup defaults to the root when no mailbox prefix is supplied; advanced defaults to a subdomain. Subdomain preserves existing domain mail. Migrate requests Mailboxes at the exact domain. An occupied exact domain or lane requires a request through sending-domain-migrations followed by authorization in the signed-in Banger Approvals panel. Agent credentials cannot authorize migration. No old messages are imported and DNS is never changed automatically.

root_dmarc_confirmedboolean

Legacy compatibility field; existing policies are preserved and setup requires no confirmation.

Response

Existing migration request returned idempotently.

Changes

No recorded changes to this operation across all 2 revisions of this API.