---
title: Email Sending
---

[Skip to content](#_top)

[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.

[Link to this property](<#(resource)%20email_sending.subdomains%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20zone_id>)

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.

[Link to this property](<#(resource)%20email_sending.subdomains%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20name>)

##### 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.

[Link to this property](<#(resource)%20email_sending.subdomains%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20drop_suppressed_recipients>)

preview\_enabled?: Bool

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

[Link to this property](<#(resource)%20email_sending.subdomains%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20preview_enabled>)

##### computed Expand Collapse

id: String

Sending subdomain identifier.

[Link to this property](<#(resource)%20email_sending.subdomains%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20id>)

tag: String

Sending subdomain identifier.

[Link to this property](<#(resource)%20email_sending.subdomains%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20tag>)

created: Time

The date and time the destination address has been created.

[Link to this property](<#(resource)%20email_sending.subdomains%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20created>)

dkim\_selector: String

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

[Link to this property](<#(resource)%20email_sending.subdomains%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20dkim_selector>)

enabled: Bool

Whether Email Sending is enabled on this subdomain.

[Link to this property](<#(resource)%20email_sending.subdomains%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20enabled>)

modified: Time

The date and time the destination address was last modified.

[Link to this property](<#(resource)%20email_sending.subdomains%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20modified>)

return\_path\_domain: String

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

[Link to this property](<#(resource)%20email_sending.subdomains%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20return_path_domain>)

### cloudflare\_email\_sending\_subdomain

Terraform

HTTPTypeScriptPythonGoTerraform

```
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.

[Link to this property](<#(resource)%20email_sending.subdomains%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20subdomain_id>)

zone\_id: String

Identifier.

[Link to this property](<#(resource)%20email_sending.subdomains%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20zone_id>)

##### computed Expand Collapse

id: String

Sending subdomain identifier.

[Link to this property](<#(resource)%20email_sending.subdomains%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20id>)

created: Time

The date and time the destination address has been created.

[Link to this property](<#(resource)%20email_sending.subdomains%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20created>)

dkim\_selector: String

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

[Link to this property](<#(resource)%20email_sending.subdomains%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20dkim_selector>)

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.

[Link to this property](<#(resource)%20email_sending.subdomains%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20drop_suppressed_recipients>)

enabled: Bool

Whether Email Sending is enabled on this subdomain.

[Link to this property](<#(resource)%20email_sending.subdomains%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20enabled>)

modified: Time

The date and time the destination address was last modified.

[Link to this property](<#(resource)%20email_sending.subdomains%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20modified>)

name: String

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

[Link to this property](<#(resource)%20email_sending.subdomains%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20name>)

preview\_enabled: Bool

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

[Link to this property](<#(resource)%20email_sending.subdomains%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20preview_enabled>)

return\_path\_domain: String

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

[Link to this property](<#(resource)%20email_sending.subdomains%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20return_path_domain>)

tag: String

Sending subdomain identifier.

[Link to this property](<#(resource)%20email_sending.subdomains%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20tag>)

### cloudflare\_email\_sending\_subdomain

Terraform

HTTPTypeScriptPythonGoTerraform

```
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.

[Link to this property](<#(resource)%20email_sending.subdomains%20%3E%20(terraform%20datasource-plural)%20%3E%20(attribute)%20zone_id>)

##### optional Expand Collapse

max\_items?: Int64

Max items to fetch, default: 1000

[Link to this property](<#(resource)%20email_sending.subdomains%20%3E%20(terraform%20datasource-plural)%20%3E%20(attribute)%20max_items>)

##### computed Expand Collapse

<details>

<summary>

result: List\[Attributes]

The items returned by the data source

</summary>

id: String

Sending subdomain identifier.

<a href="#(resource)%20email_sending.subdomains%20%3E%20(terraform%20datasource-plural)%20%3E%20(attribute)%20result%20%3E%20(attribute)%20id">Link to this property</a>

enabled: Bool

Whether Email Sending is enabled on this subdomain.

<a href="#(resource)%20email_sending.subdomains%20%3E%20(terraform%20datasource-plural)%20%3E%20(attribute)%20result%20%3E%20(attribute)%20enabled">Link to this property</a>

name: String

The exact domain name or a leftmost wildcard such as <code>*.example.com</code>.

<a href="#(resource)%20email_sending.subdomains%20%3E%20(terraform%20datasource-plural)%20%3E%20(attribute)%20result%20%3E%20(attribute)%20name">Link to this property</a>

tag: String

Sending subdomain identifier.

<a href="#(resource)%20email_sending.subdomains%20%3E%20(terraform%20datasource-plural)%20%3E%20(attribute)%20result%20%3E%20(attribute)%20tag">Link to this property</a>

created: Time

The date and time the destination address has been created.

<a href="#(resource)%20email_sending.subdomains%20%3E%20(terraform%20datasource-plural)%20%3E%20(attribute)%20result%20%3E%20(attribute)%20created">Link to this property</a>

dkim\_selector: String

The DKIM selector used for email signing. Wildcard rows publish the selector and sign with <code>d=&lt;base&gt;</code>.

<a href="#(resource)%20email_sending.subdomains%20%3E%20(terraform%20datasource-plural)%20%3E%20(attribute)%20result%20%3E%20(attribute)%20dkim_selector">Link to this property</a>

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.

<a href="#(resource)%20email_sending.subdomains%20%3E%20(terraform%20datasource-plural)%20%3E%20(attribute)%20result%20%3E%20(attribute)%20drop_suppressed_recipients">Link to this property</a>

modified: Time

The date and time the destination address was last modified.

<a href="#(resource)%20email_sending.subdomains%20%3E%20(terraform%20datasource-plural)%20%3E%20(attribute)%20result%20%3E%20(attribute)%20modified">Link to this property</a>

preview\_enabled: Bool

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

<a href="#(resource)%20email_sending.subdomains%20%3E%20(terraform%20datasource-plural)%20%3E%20(attribute)%20result%20%3E%20(attribute)%20preview_enabled">Link to this property</a>

return\_path\_domain: String

The return-path domain used for bounce handling. Wildcard rows use <code>cf-bounce.&lt;base&gt;</code>.

<a href="#(resource)%20email_sending.subdomains%20%3E%20(terraform%20datasource-plural)%20%3E%20(attribute)%20result%20%3E%20(attribute)%20return_path_domain">Link to this property</a>

</details>

[Link to this property](<#(resource)%20email_sending.subdomains%20%3E%20(terraform%20datasource-plural)%20%3E%20(attribute)%20result>)

### cloudflare\_email\_sending\_subdomains

Terraform

HTTPTypeScriptPythonGoTerraform

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