Claiming a domain

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

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.

Add the TXT record

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

Verify the claim

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

Track the status

Poll Get Domain Claim until the claim reaches completed.

Claim status

Status	Meaning
`pending`	Waiting for DNS verification.
`verified`	DNS proof accepted. The transfer is in progress.
`completed`	The domain now belongs to your team.
`blocked`	A safety check blocked the claim. See `blocked_reason`.
`expired`	The claim window passed before it completed.
`superseded`	A newer claim replaced this one.
`canceled`	The claim was canceled.
`failed`	The claim did not complete.

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.

​How it works

​Claim status

​Canceling a claim

How it works

Claim status

Canceling a claim