v2

latestOpenAPI 3.1.0MIT2026-07-26105151330.5 KB

Domains

Set Up Domain (Both Streams)

Provision both sending identities on a domain you own in one call: send.<rootDomain> (marketing) and notify.<rootDomain> (transactional). Isolates transactional reputation from marketing sends. Idempotent — safe to call again if DNS records already exist. Returns DNS records for both identities. Requires API key with domains:write.

post/v1/domains/setup

Request body

rootDomainstring required

The apex domain you own, e.g. 'acme.com'

fromNamestring

Default From display name for provisioned identities.

vanityRootFromboolean

Show the apex domain in the From header when DMARC passes. Defaults to true.

Response

Domain setup complete

successboolean

dataobject