Skip to main content
POST
/
v1
/
domains
/
claims
Initiate Domain Claim
curl --request POST \
  --url https://api.migma.ai/v1/domains/claims \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "domain": "<string>"
}
'
{
  "success": true,
  "data": {
    "message": "<string>",
    "rootDomain": "<string>",
    "record": {
      "name": "<string>",
      "value": "<string>",
      "priority": 123
    }
  },
  "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

Body

application/json
domain
string
required

The domain you want to claim, e.g. 'acme.com' or 'send.acme.com'. The root apex is resolved automatically.

Response

Claim challenge returned. Publish the TXT record, then call /v1/domains/claims/{domain}/verify.

success
boolean
required
data
object
error
string | null