---
title: Email Sending
---

[Skip to content](#%5Ftop) 

[API Reference](https://developers.cloudflare.com/api/terraform)

Copy Markdown

Open in **Claude**

Open in **ChatGPT**

Open in **Cursor**

---

**Copy Markdown**

**View as Markdown**

# Email Sending

#### Email SendingSubdomains

#### resource cloudflare\_email\_sending\_subdomain

##### required Expand Collapse 

zone\_id: String

Identifier.

name: String

The domain name within the zone. A wildcard is allowed only as the complete leftmost label (`*.example.com`) and requires the account wildcard Email Sending entitlement.

##### optional Expand Collapse 

drop\_suppressed\_recipients?: Bool

Whether a send request that includes a recipient suppressed on this subdomain drops that recipient and still delivers to the rest, instead of failing the entire request.

preview\_enabled?: Bool

Whether sent messages from this subdomain can be previewed in the activity log.

##### computed Expand Collapse 

id: String

Sending subdomain identifier.

tag: String

Sending subdomain identifier.

created: Time

The date and time the destination address has been created.

dkim\_selector: String

The DKIM selector used for email signing. Wildcard rows publish the selector and sign with `d=<base>`.

enabled: Bool

Whether Email Sending is enabled on this subdomain.

modified: Time

The date and time the destination address was last modified.

return\_path\_domain: String

The return-path domain used for bounce handling. Wildcard rows use `cf-bounce.<base>`.

### cloudflare\_email\_sending\_subdomain

Terraform

HTTPHTTP

TypeScriptTypeScript

PythonPython

GoGo

TerraformTerraform

```
resource "cloudflare_email_sending_subdomain" "example_email_sending_subdomain" {
  zone_id = "023e105f4ecef8ad9ca31a8372d0c353"
  name = "sub.example.com"
}

```

#### data cloudflare\_email\_sending\_subdomain

##### required Expand Collapse 

subdomain\_id: String

Sending subdomain identifier.

zone\_id: String

Identifier.

##### computed Expand Collapse 

id: String

Sending subdomain identifier.

created: Time

The date and time the destination address has been created.

dkim\_selector: String

The DKIM selector used for email signing. Wildcard rows publish the selector and sign with `d=<base>`.

drop\_suppressed\_recipients: Bool

Whether a send request that includes a recipient suppressed on this subdomain drops that recipient and still delivers to the rest, instead of failing the entire request.

enabled: Bool

Whether Email Sending is enabled on this subdomain.

modified: Time

The date and time the destination address was last modified.

name: String

The exact domain name or a leftmost wildcard such as `*.example.com`.

preview\_enabled: Bool

Whether sent messages from this subdomain can be previewed in the activity log.

return\_path\_domain: String

The return-path domain used for bounce handling. Wildcard rows use `cf-bounce.<base>`.

tag: String

Sending subdomain identifier.

### cloudflare\_email\_sending\_subdomain

Terraform

HTTPHTTP

TypeScriptTypeScript

PythonPython

GoGo

TerraformTerraform

```
data "cloudflare_email_sending_subdomain" "example_email_sending_subdomain" {
  zone_id = "023e105f4ecef8ad9ca31a8372d0c353"
  subdomain_id = "aabbccdd11223344aabbccdd11223344"
}

```

#### data cloudflare\_email\_sending\_subdomains

##### required Expand Collapse 

zone\_id: String

Identifier.

##### optional Expand Collapse 

max\_items?: Int64

Max items to fetch, default: 1000

##### computed Expand Collapse 

result: List\[Attributes\]

The items returned by the data source

id: String

Sending subdomain identifier.

enabled: Bool

Whether Email Sending is enabled on this subdomain.

name: String

The exact domain name or a leftmost wildcard such as `*.example.com`.

tag: String

Sending subdomain identifier.

created: Time

The date and time the destination address has been created.

dkim\_selector: String

The DKIM selector used for email signing. Wildcard rows publish the selector and sign with `d=<base>`.

drop\_suppressed\_recipients: Bool

Whether a send request that includes a recipient suppressed on this subdomain drops that recipient and still delivers to the rest, instead of failing the entire request.

modified: Time

The date and time the destination address was last modified.

preview\_enabled: Bool

Whether sent messages from this subdomain can be previewed in the activity log.

return\_path\_domain: String

The return-path domain used for bounce handling. Wildcard rows use `cf-bounce.<base>`.

### cloudflare\_email\_sending\_subdomains

Terraform

HTTPHTTP

TypeScriptTypeScript

PythonPython

GoGo

TerraformTerraform

```
data "cloudflare_email_sending_subdomains" "example_email_sending_subdomains" {
  zone_id = "023e105f4ecef8ad9ca31a8372d0c353"
}

```