Claiming a domain

When you try to add a domain that another account has already verified, MailBlastr blocks the creation and tells you the domain can be claimed. Claiming lets you prove control of the domain over DNS and transfer it to your account — entirely over the API.

How it works

1. 1
   Start a claim

   Call Claim domain with the domain name. MailBlastr creates a placeholder domain on your account and returns a domain_claim containing a TXT record to add to your DNS.

2. 2
   Add the TXT record

   Publish the returned TXT record at your DNS provider. It proves you control the domain.

3. 3
   Verify the claim

   Call Verify domain claim. MailBlastr checks the TXT record and, once it resolves, transfers the domain to your account.

4. 4
   Track the status

   Poll Get domain claim until the claim reaches completed.

Claim statuses

Start a claim

import { MailBlastr } from 'mailblastr';

const mb = new MailBlastr('mb_xxxxxxxxx');

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

Canceling a claim

Cancel a pending claim by deleting its placeholder domain with Delete domain, using the domain_id from the domain_claim object.