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. When supplied it must be an available region — us-east-1 or ap-south-1. Any other value, including a region listed as coming soon, returns a validation_error (422); this endpoint does not fall back to the default. Omit it to use the default 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.

Errors: missing_required_field (422) if name is absent; validation_error (422) if name is not a valid domain, the domain already exists on your account, or region is not an available region; plan_limit_reached (402) when your account is already at its plan's domain limit — the body carries kind: "domains" with used, limit, requested and next_plan. See Errors.