Manage custom email domains for sending notifications via Resend.Prerequisites#
You must configure a Resend API key via BYOK before using domain endpoints.Endpoints#
Get Your Domain#
Retrieve your configured email domain.Request#
Response#
{
"domain": {
"id": "domain-uuid-here",
"domain_name": "notifications.example.com",
"resend_domain_id": "d91cd9bd-1176-453e-8fc1-35364d380206",
"status": "verified",
"region": "eu-west-1",
"records": [
{
"type": "TXT",
"name": "_dmarc",
"value": "v=DMARC1; p=none",
"status": "verified"
}
],
"created_at": "2025-12-13T10:00:00.000Z",
"verified_at": "2025-12-13T10:30:00.000Z"
}
}
null for domain if none is configured.
Add a Domain#
Create a custom email domain in Resend. You can only have one domain configured at a time.Request Body#
| Field | Type | Required | Description |
|---|
domain_name | string | Yes | Fully qualified domain name |
Example Request#
Response (201 Created)#
{
"domain": {
"id": "domain-uuid-here",
"domain_name": "notifications.example.com",
"status": "pending",
"records": [
{
"type": "TXT",
"name": "_resend",
"value": "...",
"status": "not_started"
}
]
}
}
/domains/verify.Errors#
| Status | Description |
|---|
| 409 | Domain already exists |
Delete Your Domain#
Remove your configured email domain.
List Resend Domains#
Fetch all domains configured in your Resend account.Response#
{
"domains": [
{
"id": "resend-domain-id",
"name": "notifications.example.com",
"status": "verified",
"created_at": "2025-12-13T10:00:00.000Z"
}
],
"selectedDomainId": "resend-domain-id"
}
Select and Sync a Resend Domain#
Select an existing domain from your Resend account.Request Body#
| Field | Type | Required | Description |
|---|
resendDomainId | string | Yes | Resend domain ID to sync |
Verify Domain DNS Records#
Trigger domain verification in Resend.
Refresh Domain Status#
Fetch the latest domain status from Resend. Modified at 2025-12-29 14:18:47
