import { Resend } from 'resend';
const resend = new Resend('re_xxxxxxxxx');
const { data, error } = await resend.domains.create({ name: 'example.com' });
$resend = Resend::client('re_xxxxxxxxx');
$resend->domains->create([
'name' => 'example.com'
]);
import resend
resend.api_key = "re_xxxxxxxxx"
params: resend.Domains.CreateParams = {
"name": "example.com",
}
resend.Domains.create(params)
Resend.api_key = ENV["RESEND_API_KEY"]
params = {
name: "example.com",
}
domain = Resend::Domains.create(params)
puts domain
package main
import "github.com/resend/resend-go/v3"
func main() {
client := resend.NewClient("re_xxxxxxxxx")
params := &resend.CreateDomainRequest{
Name: "example.com",
}
client.Domains.Create(params)
}
use resend_rs::{types::CreateDomainOptions, Resend, Result};
#[tokio::main]
async fn main() -> Result<()> {
let resend = Resend::new("re_xxxxxxxxx");
let _domain = resend
.domains
.create(CreateDomainOptions::new("example.com"))
.await?;
Ok(())
}
import com.resend.*;
public class Main {
public static void main(String[] args) {
Resend resend = new Resend("re_xxxxxxxxx");
CreateDomainOptions params = CreateDomainOptions
.builder()
.name("example.com").build();
CreateDomainResponse domain = resend.domains().create(params);
}
}
using Resend;
IResend resend = ResendClient.Create( "re_xxxxxxxxx" ); // Or from DI
var resp = await resend.DomainAddAsync( "example.com" );
Console.WriteLine( "Domain Id={0}", resp.Content.Id );
curl -X POST 'https://api.resend.com/domains' \
-H 'Authorization: Bearer re_xxxxxxxxx' \
-H 'Content-Type: application/json' \
-d $'{
"name": "example.com"
}'
resend domains create --name example.com --region us-east-1
{
"id": "4dd369bc-aa82-4ff3-97de-514ae3000ee0",
"name": "example.com",
"created_at": "2026-03-28 17:12:02.059593+00",
"status": "not_started",
"open_tracking": true,
"click_tracking": false,
"tracking_subdomain": "links",
"capabilities": {
"sending": "enabled",
"receiving": "disabled"
},
"records": [
{
"record": "SPF",
"name": "send",
"type": "MX",
"ttl": "Auto",
"status": "not_started",
"value": "feedback-smtp.us-east-1.amazonses.com",
"priority": 10
},
{
"record": "SPF",
"name": "send",
"value": "\"v=spf1 include:amazonses.com ~all\"",
"type": "TXT",
"ttl": "Auto",
"status": "not_started"
},
{
"record": "DKIM",
"name": "nhapbbryle57yxg3fbjytyodgbt2kyyg._domainkey",
"value": "nhapbbryle57yxg3fbjytyodgbt2kyyg.dkim.amazonses.com.",
"type": "CNAME",
"status": "not_started",
"ttl": "Auto"
},
{
"record": "DKIM",
"name": "xbakwbe5fcscrhzshpap6kbxesf6pfgn._domainkey",
"value": "xbakwbe5fcscrhzshpap6kbxesf6pfgn.dkim.amazonses.com.",
"type": "CNAME",
"status": "not_started",
"ttl": "Auto"
},
{
"record": "DKIM",
"name": "txrcreso3dqbvcve45tqyosxwaegvhgn._domainkey",
"value": "txrcreso3dqbvcve45tqyosxwaegvhgn.dkim.amazonses.com.",
"type": "CNAME",
"status": "not_started",
"ttl": "Auto"
},
{
"record": "Tracking",
"name": "links.example.com",
"type": "CNAME",
"value": "links1.resend-dns.com",
"ttl": "Auto",
"status": "not_started"
}
],
"region": "us-east-1"
}
Create Domain
Create a domain through the Resend Email API.
POST
/
domains
import { Resend } from 'resend';
const resend = new Resend('re_xxxxxxxxx');
const { data, error } = await resend.domains.create({ name: 'example.com' });
$resend = Resend::client('re_xxxxxxxxx');
$resend->domains->create([
'name' => 'example.com'
]);
import resend
resend.api_key = "re_xxxxxxxxx"
params: resend.Domains.CreateParams = {
"name": "example.com",
}
resend.Domains.create(params)
Resend.api_key = ENV["RESEND_API_KEY"]
params = {
name: "example.com",
}
domain = Resend::Domains.create(params)
puts domain
package main
import "github.com/resend/resend-go/v3"
func main() {
client := resend.NewClient("re_xxxxxxxxx")
params := &resend.CreateDomainRequest{
Name: "example.com",
}
client.Domains.Create(params)
}
use resend_rs::{types::CreateDomainOptions, Resend, Result};
#[tokio::main]
async fn main() -> Result<()> {
let resend = Resend::new("re_xxxxxxxxx");
let _domain = resend
.domains
.create(CreateDomainOptions::new("example.com"))
.await?;
Ok(())
}
import com.resend.*;
public class Main {
public static void main(String[] args) {
Resend resend = new Resend("re_xxxxxxxxx");
CreateDomainOptions params = CreateDomainOptions
.builder()
.name("example.com").build();
CreateDomainResponse domain = resend.domains().create(params);
}
}
using Resend;
IResend resend = ResendClient.Create( "re_xxxxxxxxx" ); // Or from DI
var resp = await resend.DomainAddAsync( "example.com" );
Console.WriteLine( "Domain Id={0}", resp.Content.Id );
curl -X POST 'https://api.resend.com/domains' \
-H 'Authorization: Bearer re_xxxxxxxxx' \
-H 'Content-Type: application/json' \
-d $'{
"name": "example.com"
}'
resend domains create --name example.com --region us-east-1
{
"id": "4dd369bc-aa82-4ff3-97de-514ae3000ee0",
"name": "example.com",
"created_at": "2026-03-28 17:12:02.059593+00",
"status": "not_started",
"open_tracking": true,
"click_tracking": false,
"tracking_subdomain": "links",
"capabilities": {
"sending": "enabled",
"receiving": "disabled"
},
"records": [
{
"record": "SPF",
"name": "send",
"type": "MX",
"ttl": "Auto",
"status": "not_started",
"value": "feedback-smtp.us-east-1.amazonses.com",
"priority": 10
},
{
"record": "SPF",
"name": "send",
"value": "\"v=spf1 include:amazonses.com ~all\"",
"type": "TXT",
"ttl": "Auto",
"status": "not_started"
},
{
"record": "DKIM",
"name": "nhapbbryle57yxg3fbjytyodgbt2kyyg._domainkey",
"value": "nhapbbryle57yxg3fbjytyodgbt2kyyg.dkim.amazonses.com.",
"type": "CNAME",
"status": "not_started",
"ttl": "Auto"
},
{
"record": "DKIM",
"name": "xbakwbe5fcscrhzshpap6kbxesf6pfgn._domainkey",
"value": "xbakwbe5fcscrhzshpap6kbxesf6pfgn.dkim.amazonses.com.",
"type": "CNAME",
"status": "not_started",
"ttl": "Auto"
},
{
"record": "DKIM",
"name": "txrcreso3dqbvcve45tqyosxwaegvhgn._domainkey",
"value": "txrcreso3dqbvcve45tqyosxwaegvhgn.dkim.amazonses.com.",
"type": "CNAME",
"status": "not_started",
"ttl": "Auto"
},
{
"record": "Tracking",
"name": "links.example.com",
"type": "CNAME",
"value": "links1.resend-dns.com",
"ttl": "Auto",
"status": "not_started"
}
],
"region": "us-east-1"
}
Body Parameters
The name of the domain you want to create.
The region where emails will be sent from. Possible values:
'us-east-1' | 'eu-west-1' | 'sa-east-1' | 'ap-northeast-1'opportunistic: Opportunistic TLS means that it always attempts to make a secure connection to the receiving mail server. If it can’t establish a secure connection, it sends the message unencrypted.enforced: Enforced TLS on the other hand, requires that the email communication must use TLS no matter what. If the receiving server does not support TLS, the email will not be sent.
Configure the domain capabilities for sending and receiving emails. At least one capability must be enabled.
See all available
status types in the Domains
overview.import { Resend } from 'resend';
const resend = new Resend('re_xxxxxxxxx');
const { data, error } = await resend.domains.create({ name: 'example.com' });
$resend = Resend::client('re_xxxxxxxxx');
$resend->domains->create([
'name' => 'example.com'
]);
import resend
resend.api_key = "re_xxxxxxxxx"
params: resend.Domains.CreateParams = {
"name": "example.com",
}
resend.Domains.create(params)
Resend.api_key = ENV["RESEND_API_KEY"]
params = {
name: "example.com",
}
domain = Resend::Domains.create(params)
puts domain
package main
import "github.com/resend/resend-go/v3"
func main() {
client := resend.NewClient("re_xxxxxxxxx")
params := &resend.CreateDomainRequest{
Name: "example.com",
}
client.Domains.Create(params)
}
use resend_rs::{types::CreateDomainOptions, Resend, Result};
#[tokio::main]
async fn main() -> Result<()> {
let resend = Resend::new("re_xxxxxxxxx");
let _domain = resend
.domains
.create(CreateDomainOptions::new("example.com"))
.await?;
Ok(())
}
import com.resend.*;
public class Main {
public static void main(String[] args) {
Resend resend = new Resend("re_xxxxxxxxx");
CreateDomainOptions params = CreateDomainOptions
.builder()
.name("example.com").build();
CreateDomainResponse domain = resend.domains().create(params);
}
}
using Resend;
IResend resend = ResendClient.Create( "re_xxxxxxxxx" ); // Or from DI
var resp = await resend.DomainAddAsync( "example.com" );
Console.WriteLine( "Domain Id={0}", resp.Content.Id );
curl -X POST 'https://api.resend.com/domains' \
-H 'Authorization: Bearer re_xxxxxxxxx' \
-H 'Content-Type: application/json' \
-d $'{
"name": "example.com"
}'
resend domains create --name example.com --region us-east-1
{
"id": "4dd369bc-aa82-4ff3-97de-514ae3000ee0",
"name": "example.com",
"created_at": "2026-03-28 17:12:02.059593+00",
"status": "not_started",
"open_tracking": true,
"click_tracking": false,
"tracking_subdomain": "links",
"capabilities": {
"sending": "enabled",
"receiving": "disabled"
},
"records": [
{
"record": "SPF",
"name": "send",
"type": "MX",
"ttl": "Auto",
"status": "not_started",
"value": "feedback-smtp.us-east-1.amazonses.com",
"priority": 10
},
{
"record": "SPF",
"name": "send",
"value": "\"v=spf1 include:amazonses.com ~all\"",
"type": "TXT",
"ttl": "Auto",
"status": "not_started"
},
{
"record": "DKIM",
"name": "nhapbbryle57yxg3fbjytyodgbt2kyyg._domainkey",
"value": "nhapbbryle57yxg3fbjytyodgbt2kyyg.dkim.amazonses.com.",
"type": "CNAME",
"status": "not_started",
"ttl": "Auto"
},
{
"record": "DKIM",
"name": "xbakwbe5fcscrhzshpap6kbxesf6pfgn._domainkey",
"value": "xbakwbe5fcscrhzshpap6kbxesf6pfgn.dkim.amazonses.com.",
"type": "CNAME",
"status": "not_started",
"ttl": "Auto"
},
{
"record": "DKIM",
"name": "txrcreso3dqbvcve45tqyosxwaegvhgn._domainkey",
"value": "txrcreso3dqbvcve45tqyosxwaegvhgn.dkim.amazonses.com.",
"type": "CNAME",
"status": "not_started",
"ttl": "Auto"
},
{
"record": "Tracking",
"name": "links.example.com",
"type": "CNAME",
"value": "links1.resend-dns.com",
"ttl": "Auto",
"status": "not_started"
}
],
"region": "us-east-1"
}
Was this page helpful?
⌘I