API Reference

Verify Domain Claim

POST /domains/:domain_id/claim/verify — trigger DNS verification for a domain claim.

POST/domains/:domain_id/claim/verify

Starts an asynchronous verification process for a domain claim. MailBlastr checks the claim’s TXT record and, once it resolves, transfers the domain to your account. Add the TXT record returned by Claim Domain before calling this, then poll Get Domain Claim to follow the status.

After the claim completes, the domain is transferred to your account as a brand-new domain with its own DKIM keys — the previous account’s DNS records can’t be reused. Fetch it with Retrieve a domain, publish the new DKIM record(s), then run Verify a domain to finish setup before sending.

Path parameters

domain_idstringrequired

The placeholder domain id returned when the claim was created.

import { MailBlastr } from 'mailblastr';

const mb = new MailBlastr('mb_xxxxxxxxx');

const { data, error } = await mb.domains.verifyClaim('d91cd9bd-1176-453e-8fc1-35364d380206');
console.log({ data, error });

Response

{
  "object": "domain_claim",
  "id": "dacf4072-4119-4d88-932f-6c6126d3a9d1",
  "name": "yourdomain.com",
  "status": "pending",
  "domain_id": "d91cd9bd-1176-453e-8fc1-35364d380206",
  "region": "us-east-1",
  "record": {
    "type": "TXT",
    "name": "yourdomain.com",
    "value": "mailblastr-domain-verification=3f8a1c2d4e5b6a7f8091a2b3c4d5e6f7",
    "ttl": "Auto"
  },
  "blocked_reason": null,
  "failure_reason": null,
  "created_at": "2026-06-16T17:12:02.059Z",
  "expires_at": "2026-06-23T17:12:02.059Z"
}

Errors: not_found if the claim does not exist or is not yours. See Errors.