---
title: "Set Up Domain (Both Streams)"
method: POST
path: "/v1/domains/setup"
tags: ["Domains"]
---

# Set Up Domain (Both Streams)

`POST /v1/domains/setup`

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.

## Request body

- object
  - `rootDomain` string, required — The apex domain you own, e.g. 'acme.com'
  - `fromName` string — Default From display name for provisioned identities.
  - `vanityRootFrom` boolean — Show the apex domain in the From header when DMARC passes. Defaults to true.

## Response `200`

Domain setup complete

- object
  - `success` boolean
  - `data` object

## 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/versions/3f3dba69574b/schema)