v2

latestOpenAPI 3.1.0MIT2026-07-26105151330.5 KB
Domains

Confirm Domain Claim

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.

post/v1/domains/claims/{domain}/verify

Path parameters

domainstring required

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

Headers

Idempotency-Keystring

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.

Response

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

successboolean required
errorstring nullable