---
title: "Confirm Domain Claim"
method: POST
path: "/v1/domains/claims/{domain}/verify"
tags: ["Domains"]
---

# Confirm Domain Claim

`POST /v1/domains/claims/{domain}/verify`

Complete a domain claim after the proof TXT record is live. Migma verifies DNS ownership, releases the domain from its current owner, and provisions fresh sending identities under your account. Domains that are actively sending require manual review. Requires API key with domain:write.

## Path parameters

- `domain` string, required

## Headers

- `Idempotency-Key` string

## Response `200`

Domain claimed and fresh identities provisioned. Add the DNS records for both identities, then verify them.

- ApiResponseDomainClaimResult
  - `success` boolean, required
  - `data` object, nullable
    - `message` string
    - `marketing` SendingDomain
      - `_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
    - `transactional` SendingDomain
      - `_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
- `403` — Forbidden - Missing required permissions or access denied
- `409` — Conflict - the Idempotency-Key was reused with a different request body (code: IDEMPOTENCY_CONFLICT)

---

[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)