API Reference

Claim Domain

POST /domains/claim — claim a domain that is already verified by another account.

POST/domains/claim

Claims a domain that is already verified by another MailBlastr account. Use this when creating a domain fails because the domain is already in use elsewhere. MailBlastr creates a placeholder domain on your account and returns a domain_claim object with a single TXT record to publish at your DNS provider. After publishing it, call Verify Domain Claim and poll Get Domain Claim to follow the status.

Body parameters

namestringrequired

The name of the domain you want to claim, e.g. yourdomain.com.

regionstringoptional

Optional, for compatibility. The claim is always pinned to MailBlastr’s configured region. See Choosing a region.

import { MailBlastr } from 'mailblastr';

const mb = new MailBlastr('mb_xxxxxxxxx');

const { data, error } = await mb.domains.claim({
  "name": "yourdomain.com"
});
console.log({ data, error });

Response

The domain_claim object. The domain_id is the placeholder domain id — use it for the get and verify calls below.

{
  "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"
}

The claim expires_at roughly a week after creation. Publish the TXT record and verify before then, or start a new claim.