curl -X POST 'https://api.resend.com/domains/claim' \
  -H "Authorization: Bearer $RESEND_API_KEY" \
  -H 'User-Agent: my-app/1.0' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "string",
  "region": "us-east-1",
  "custom_return_path": "send",
  "open_tracking": true,
  "click_tracking": true,
  "tracking_subdomain": "string"
}'

# POST /domains/claim (Resend API)
Base URL: https://api.resend.com
Auth: Authorization: Bearer <RESEND_API_KEY>
Last verified: 2026-09-03

> Claim a domain

## Critical Gotchas
* All requests must include a `User-Agent` header (e.g. `User-Agent: my-app/1.0`) or the API returns HTTP 403.
* The `to` field is an array of strings, even when sending to a single recipient.

## cURL
curl -X POST 'https://api.resend.com/domains/claim' \
  -H "Authorization: Bearer $RESEND_API_KEY" \
  -H 'User-Agent: my-app/1.0' \
  -H 'Content-Type: application/json' \
  -d '{"name":"string","region":"us-east-1"}'

## Parameters
| Name | In | Type | Required | Description |
| :--- | :--- | :--- | :--- | :--- |
| name | body | string | Yes | The name of the domain you want to cl... |
| region | body | string | No | The region where emails will be sent... |
| custom_return_path | body | string | No | For advanced use cases, choose a subd... |

## Response (200 OK)
{"object":"domain_claim","id":"d91cd9bd-1176-453e-8fc1-35364d380206"}

---
Need an API key? Get one at https://resend.com/signup

POST

/domains/claim

Resend API

Claim a domain

Base URL: https://api.resend.com
Auth: Authorization: Bearer <RESEND_API_KEY>
Last verified: 2026-09-03 · upstream hash matched

Actions

Agents: curl -H "Accept: text/markdown" this URL
→ 219 tokens · Vary: Accept

Critical gotchas

All requests must include a User-Agent header (e.g. User-Agent: my-app/1.0) or the API returns HTTP 403.

The to field is an array of strings, even when sending to a single recipient.

cURL

curl -X POST 'https://api.resend.com/domains/claim' \  -H "Authorization: Bearer $RESEND_API_KEY" \  -H 'User-Agent: my-app/1.0' \  -H 'Content-Type: application/json' \  -d '{  "name": "string",  "region": "us-east-1",  "custom_return_path": "send",  "open_tracking": true,  "click_tracking": true,  "tracking_subdomain": "string"}'

Get a free Resend API key → sponsored

Parameters

Name	In	Type	Required	Description
name	body	string	Yes	The name of the domain you want to claim.
region	body	string	No	The region where emails will be sent from. Possible values are us-east-1 \| eu-west-1 \| sa-east-1 \| ap-northeast-1
custom_return_path	body	string	No	For advanced use cases, choose a subdomain for the Return-Path address. Defaults to 'send' (i.e., send.yourdomain.tld).
open_tracking	body	boolean	No	Track the open rate of each email.
click_tracking	body	boolean	No	Track clicks within the body of each HTML email.
tracking_subdomain	body	string	No	The subdomain to use for click and open tracking.

Response 200 OK

{
  "object": "domain_claim",
  "id": "d91cd9bd-1176-453e-8fc1-35364d380206",
  "name": "example.com",
  "status": "pending",
  "domain_id": "a1b2c3d4-1176-453e-8fc1-35364d380206",
  "region": "us-east-1",
  "record": {
    "type": "TXT",
    "name": "example.com",
    "value": "resend-domain-verification=abc123",
    "ttl": "Auto"
  },
  "blocked_reason": null,
  "failure_reason": null,
  "created_at": "2023-04-26 20:21:26.347412+00",
  "expires_at": "2023-05-03 20:21:26.347412+00"
}