Skip to main content
POST
/
v1
/
domains
/
claims
/
{domain}
/
verify
Confirm Domain Claim
curl --request POST \
  --url https://api.migma.ai/v1/domains/claims/{domain}/verify \
  --header 'Authorization: <api-key>'
{
  "success": true,
  "data": {
    "message": "<string>",
    "marketing": {
      "_id": "<string>",
      "domain": "<string>",
      "regionName": "<string>",
      "mailFromDomain": "<string>",
      "dnsRecords": [
        {
          "name": "<string>",
          "value": "<string>",
          "priority": 123
        }
      ],
      "ownershipVerified": true,
      "openTracking": true,
      "clickTracking": true,
      "brandedTracking": true,
      "createdAt": "2023-11-07T05:31:56Z",
      "verifiedAt": "2023-11-07T05:31:56Z",
      "isManagedDomain": true
    },
    "transactional": {
      "_id": "<string>",
      "domain": "<string>",
      "regionName": "<string>",
      "mailFromDomain": "<string>",
      "dnsRecords": [
        {
          "name": "<string>",
          "value": "<string>",
          "priority": 123
        }
      ],
      "ownershipVerified": true,
      "openTracking": true,
      "clickTracking": true,
      "brandedTracking": true,
      "createdAt": "2023-11-07T05:31:56Z",
      "verifiedAt": "2023-11-07T05:31:56Z",
      "isManagedDomain": true
    }
  },
  "error": "<string>"
}

Authorizations

​
Authorization
string
header
required

API key authentication. Use 'Authorization: Bearer YOUR_API_KEY' where YOUR_API_KEY is obtained from the Migma dashboard under Settings → API Integration.

Headers

​
Idempotency-Key
string

Optional key (max 100 chars) for safe retries. Same key + same body within 24h replays the original response (same status and body); same key + a different body returns 409 IDEMPOTENCY_CONFLICT. Scoped per API key.

Maximum string length: 100

Path Parameters

​
domain
string
required

Domain name from the initiate claim call (e.g., acme.com).

Response

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

​
success
boolean
required
​
data
object
​
error
string | null