> ## Documentation Index
> Fetch the complete documentation index at: https://resend.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Domain

> Create a domain through the Resend Email API.

## Body Parameters

**name** `string` *required*

The name of the domain you want to create.

**region** `string` (default: us-east-1)

The region where emails will be sent from. Possible values: `'us-east-1' |
    'eu-west-1' | 'sa-east-1' | 'ap-northeast-1'`

For advanced use cases, choose a subdomain for the Return-Path address. The
custom return path is used for Sender Policy Framework (SPF)
authentication, Domain-based Message Authentication, Reporting, and
Conformance (DMARC) alignment, and handling bounced emails. Defaults to
`send` (that is, `send.yourdomain.tld`). Avoid setting values that undermine
credibility (e.g. `testing`), as they may be exposed to recipients.

Learn more about [custom return paths](https://resend.com/docs/dashboard/domains/custom-return-path.md).

Track the open rate of each email.

> [!NOTE]
>
> This setting is only applied if a `tracking_subdomain` is configured and verified.

Track clicks within the body of each HTML email.

> [!NOTE]
>
> This setting is only applied if a `tracking_subdomain` is configured and verified.

Configure a custom subdomain for click and open tracking. For example, setting
`"links"` on domain `example.com` will produce a CNAME record for
`links.example.com`. Avoid setting values that have a negative connotation (e.g. `tracking`).

Learn more about [custom tracking subdomains](https://resend.com/docs/dashboard/domains/tracking.md).

**tls** `string` (default: opportunistic)

<ul>
  <li>
    `opportunistic`: Opportunistic Transport Layer Security (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.
  </li>

  <li>
    `enforced`: Enforced Transport Layer Security (TLS) on the other hand,
    requires that the email communication must use TLS no matter what. If the
    receiving server doesn't support TLS, the email won't be sent.
  </li>
</ul>

**capabilities** `object`

Configure the domain capabilities for sending and receiving emails. At least one capability must be enabled.

**properties**

**sending** `string` (default: enabled)

Enable or disable sending emails from this domain. Possible values: `'enabled' | 'disabled'`

**receiving** `string` (default: disabled)

Enable or disable receiving emails to this domain. Possible values: `'enabled' | 'disabled'`

> [!NOTE]
>
> See all available [domain `status`
> types](https://resend.com/docs/dashboard/domains/manage-domains#understand-a-domain-status).

```ts Node.js theme={"theme":{"light":"github-light","dark":"vesper"}}
import { Resend } from 'resend';

const resend = new Resend('re_xxxxxxxxx');

const { data, error } = await resend.domains.create({ name: 'example.com' });
```

```php PHP theme={"theme":{"light":"github-light","dark":"vesper"}}
$resend = Resend::client('re_xxxxxxxxx');

$resend->domains->create([
  'name' => 'example.com'
]);
```

```python Python theme={"theme":{"light":"github-light","dark":"vesper"}}
import resend

resend.api_key = "re_xxxxxxxxx"

params: resend.Domains.CreateParams = {
  "name": "example.com",
}

resend.Domains.create(params)
```

```ruby Ruby theme={"theme":{"light":"github-light","dark":"vesper"}}
require "resend"

Resend.api_key = "re_xxxxxxxxx"

params = {
  name: "example.com",
}
domain = Resend::Domains.create(params)
puts domain
```

```go Go theme={"theme":{"light":"github-light","dark":"vesper"}}
package main

import "github.com/resend/resend-go/v4"

func main() {
	client := resend.NewClient("re_xxxxxxxxx")

	params := &resend.CreateDomainRequest{
		Name: "example.com",
	}

	client.Domains.Create(params)
}
```

```rust Rust theme={"theme":{"light":"github-light","dark":"vesper"}}
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(())
}
```

```java Java theme={"theme":{"light":"github-light","dark":"vesper"}}
import com.resend.Resend;
import com.resend.core.exception.ResendException;
import com.resend.services.domains.model.CreateDomainOptions;
import com.resend.services.domains.model.CreateDomainResponse;

public class Main {
    public static void main(String[] args) throws ResendException {
        Resend resend = new Resend("re_xxxxxxxxx");

        CreateDomainOptions params = CreateDomainOptions
                .builder()
                .name("example.com").build();

        CreateDomainResponse domain = resend.domains().create(params);
    }
}
```

```csharp .NET theme={"theme":{"light":"github-light","dark":"vesper"}}
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 );
```

```bash cURL theme={"theme":{"light":"github-light","dark":"vesper"}}
curl -X POST 'https://api.resend.com/domains' \
     -H 'Authorization: Bearer re_xxxxxxxxx' \
     -H 'Content-Type: application/json' \
     -d $'{
  "name": "example.com"
}'
```

```bash CLI theme={"theme":{"light":"github-light","dark":"vesper"}}
resend domains create --name example.com --region us-east-1
```

```json Response theme={"theme":{"light":"github-light","dark":"vesper"}}
{
  "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": "DKIM",
      "name": "resend._domainkey",
      "value": "p=MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDsc4Lh8xilsngyKEgN2S84+21gn+x6SEXtjWvPiAAmnmggr5FWG42WnqczpzQ/mNblqHz4CDwUum6LtY6SdoOlDmrhvp5khA3cd661W9FlK3yp7+jVACQElS7d9O6jv8VsBbVg4COess3gyLE5RyxqF1vYsrEXqyM8TBz1n5AGkQIDAQA2",
      "type": "TXT",
      "status": "not_started",
      "ttl": "Auto"
    },
    {
      "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": "Tracking",
      "type": "CNAME",
      "name": "links",
      "value": "links1.resend-dns.com",
      "ttl": "Auto",
      "status": "not_started"
    }
  ],
  "region": "us-east-1"
}
```
