Skip to main content
POST
Initiate Domain Claim

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 → Developers → API Keys.

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