Sign in
Domains

Provision Stream Identity

Provision a transactional or marketing sending identity on a domain you own. Creates notify.<rootDomain> (transactional) or send.<rootDomain> (marketing) to isolate transactional reputation from marketing. Returns DNS records to publish, then verify. Requires API key with domain:write.

post/v1/domains/streams

Request body

rootDomainstring required

Apex domain you own (e.g., 'acme.com'). The stream subdomain is derived from it.

stream'transactional' | 'marketing' required

'transactional' provisions notify.<rootDomain>; 'marketing' provisions send.<rootDomain>.

vanityRootFromboolean

Show the apex domain in the From header when its DMARC passes.

Response

Stream identity provisioned. Publish the returned DNS records, then verify.

successboolean required
errorstring nullable

Changes

Changed in 1 of the 7 revisions of this API.21

  • 3f3dba69574b21See the full diff
    • ●

      removed the request property

      request-property-removed

    • ●

      added the new us-east-2 enum value to the // response property for the response status

      response-property-enum-value-added

    • ○

      the response optional property // became read-only for the status

      response-optional-property-became-read-only