Domains

Provision Stream Identity

Changed on

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

  • Base URL
    https://api.migma.ai
  • URL
    https://api.migma.ai/v1/domains/streams
  • Auth
    API key in header Authorization

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

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status