post/v1/workspaces/{workspaceId}/sending-domains

Request

  • Base URL: https://api.bangermail.com
  • URL: https://api.bangermail.com/v1/workspaces/{workspaceId}/sending-domains
  • 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

Idempotent replay of a Banger-native sending-domain request.

Changes

No recorded changes to this operation across all 1 revision of this API.