---
title: "Provision Stream Identity"
method: POST
path: "/v1/domains/streams"
tags: ["Domains"]
---

# Provision Stream Identity

`POST /v1/domains/streams`

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.

## Request body

- ProvisionStreamRequest
  - `rootDomain` string, 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>.
  - `vanityRootFrom` boolean — Show the apex domain in the From header when its DMARC passes.

## Response `201`

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

- ApiResponseDomain
  - `success` boolean, required
  - `data` object, nullable
    - `_id` string
    - `domain` string
    - `region` 'us-east-1' | 'eu-west-1' | 'us-east-2' — AWS region the domain sends from. Automatically assigned at creation.
    - `regionName` string
    - `status` 'pending' | 'verifying' | 'verified' | 'degraded' | 'failed' | 'suspended'
    - `dkimStatus` 'SUCCESS' | 'PENDING' | 'FAILED' | 'NOT_STARTED'
    - `mailFromDomain` string
    - `mailFromStatus` 'SUCCESS' | 'PENDING' | 'FAILED'
    - `dnsRecords` DnsRecord[]
      - `type` 'CNAME' | 'TXT' | 'MX'
      - `name` string
      - `value` string
      - `priority` integer
      - `status` 'pending' | 'verified' | 'failed'
    - `ownershipVerified` boolean
    - `openTracking` boolean
    - `clickTracking` boolean
    - `brandedTracking` boolean
    - `createdAt` string, date-time
    - `verifiedAt` string, date-time, nullable
    - `isManagedDomain` boolean
  - `error` string, nullable

## Other responses

- `400` — Bad request
- `401` — Unauthorized

---

[API](https://skmtc.net/migma/apis/migma-ai-api-v1.md) · [All operations](https://skmtc.net/migma/apis/migma-ai-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/migma/migma-ai-api-v1/revisions/3f3dba69574b/schema)