Skip to main content
When you try to add a domain that another team has already verified, Resend 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 team — entirely over the API.

​
How it works

1

Start a claim

Call Claim Domain with the domain name. Resend creates a placeholder domain on your team and returns a domain_claim containing a TXT record to add to your DNS.
2

Add the TXT record

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

Verify the claim

Call Verify Domain Claim. Resend checks the TXT record and runs ownership-safety checks before transferring the domain.
4

Track the status

Poll Get Domain Claim until the claim reaches completed.

​
Claim status

StatusMeaning
pendingWaiting for DNS verification.
verifiedDNS proof accepted; the transfer is in progress.
completedThe domain now belongs to your team.
blockedA safety check blocked the claim — see blocked_reason.
expiredThe claim window passed before it completed.
supersededA newer claim replaced this one.
canceledThe claim was canceled.
failedThe claim could not be completed.
When a claim is blocked, blocked_reason explains why: grace_period, recent_owner_activity, or pending_scheduled_emails.

​
Canceling a claim

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