---
title: DNS
---

[Skip to content](#_top)

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

[Email Routing](https://developers.cloudflare.com/api/python/resources/email_routing)

Copy Markdown

Open in **Claude**Open in **ChatGPT**Open in **Cursor**

---

**Copy Markdown****View as Markdown**

# DNS

##### [Email Routing - DNS settings](https://developers.cloudflare.com/api/python/resources/email_routing/subresources/dns/methods/get)

email\_routing.dns.get(DNSGetParams\*\*kwargs) -> [DNSGetResponse](<https://developers.cloudflare.com/api/python/resources/email_routing#(resource)%20email_routing.dns%20%3E%20(model)%20dns_get_response%20%3E%20(schema)>)

GET/zones/{zone\_id}/email/routing/dns

##### [Enable Email Routing](https://developers.cloudflare.com/api/python/resources/email_routing/subresources/dns/methods/create)

email\_routing.dns.create(DNSCreateParams\*\*kwargs) -> [Settings](<https://developers.cloudflare.com/api/python/resources/email_routing#(resource)%20email_routing%20%3E%20(model)%20settings%20%3E%20(schema)>)

POST/zones/{zone\_id}/email/routing/dns

##### [Unlock Email Routing DNS records](https://developers.cloudflare.com/api/python/resources/email_routing/subresources/dns/methods/edit)

email\_routing.dns.edit(DNSEditParams\*\*kwargs) -> [Settings](<https://developers.cloudflare.com/api/python/resources/email_routing#(resource)%20email_routing%20%3E%20(model)%20settings%20%3E%20(schema)>)

PATCH/zones/{zone\_id}/email/routing/dns

##### [Disable Email Routing](https://developers.cloudflare.com/api/python/resources/email_routing/subresources/dns/methods/delete)

email\_routing.dns.delete(DNSDeleteParams\*\*kwargs) -> [Settings](<https://developers.cloudflare.com/api/python/resources/email_routing#(resource)%20email_routing%20%3E%20(model)%20settings%20%3E%20(schema)>)

DELETE/zones/{zone\_id}/email/routing/dns

##### ModelsExpand Collapse

<details>

<summary>

class DNSRecord: …

List of records needed to enable an Email Routing zone.

</summary>

content: Optional\[str]

DNS record content.

<a href="#(resource)%20email_routing.dns%20%3E%20(model)%20dns_record%20%3E%20(schema)%20%3E%20(property)%20content">Link to this property</a>

name: Optional\[str]

DNS record name (or @ for the zone apex).

maxLength255

<a href="#(resource)%20email_routing.dns%20%3E%20(model)%20dns_record%20%3E%20(schema)%20%3E%20(property)%20name">Link to this property</a>

priority: Optional\[float]

Required for MX, SRV and URI records. Unused by other record types. Records with lower priorities are preferred.

maximum65535

minimum0

<a href="#(resource)%20email_routing.dns%20%3E%20(model)%20dns_record%20%3E%20(schema)%20%3E%20(property)%20priority">Link to this property</a>

<details>

<summary>

ttl: Optional\[Union\[float, Literal\[1], null]]

Time to live, in seconds, of the DNS record. Must be between 60 and 86400, or 1 for ‘automatic’.

</summary>

One of the following:

float

<a href="#(resource)%20email_routing.dns%20%3E%20(model)%20dns_record%20%3E%20(schema)%20%3E%20(property)%20ttl%20%3E%20(variant)%200">Link to this property</a>

Literal\[1]

Time to live, in seconds, of the DNS record. Must be between 60 and 86400, or 1 for ‘automatic’.

<a href="#(resource)%20email_routing.dns%20%3E%20(model)%20dns_record%20%3E%20(schema)%20%3E%20(property)%20ttl%20%3E%20(variant)%201">Link to this property</a>

</details>

<a href="#(resource)%20email_routing.dns%20%3E%20(model)%20dns_record%20%3E%20(schema)%20%3E%20(property)%20ttl">Link to this property</a>

<details>

<summary>

type: Optional\[Literal\["A", "AAAA", "CNAME", 15 more]]

DNS record type.

</summary>

One of the following:

"A"

<a href="#(resource)%20email_routing.dns%20%3E%20(model)%20dns_record%20%3E%20(schema)%20%3E%20(property)%20type%20%3E%20(member)%200">Link to this property</a>

"AAAA"

<a href="#(resource)%20email_routing.dns%20%3E%20(model)%20dns_record%20%3E%20(schema)%20%3E%20(property)%20type%20%3E%20(member)%201">Link to this property</a>

"CNAME"

<a href="#(resource)%20email_routing.dns%20%3E%20(model)%20dns_record%20%3E%20(schema)%20%3E%20(property)%20type%20%3E%20(member)%202">Link to this property</a>

"HTTPS"

<a href="#(resource)%20email_routing.dns%20%3E%20(model)%20dns_record%20%3E%20(schema)%20%3E%20(property)%20type%20%3E%20(member)%203">Link to this property</a>

"TXT"

<a href="#(resource)%20email_routing.dns%20%3E%20(model)%20dns_record%20%3E%20(schema)%20%3E%20(property)%20type%20%3E%20(member)%204">Link to this property</a>

"SRV"

<a href="#(resource)%20email_routing.dns%20%3E%20(model)%20dns_record%20%3E%20(schema)%20%3E%20(property)%20type%20%3E%20(member)%205">Link to this property</a>

"LOC"

<a href="#(resource)%20email_routing.dns%20%3E%20(model)%20dns_record%20%3E%20(schema)%20%3E%20(property)%20type%20%3E%20(member)%206">Link to this property</a>

"MX"

<a href="#(resource)%20email_routing.dns%20%3E%20(model)%20dns_record%20%3E%20(schema)%20%3E%20(property)%20type%20%3E%20(member)%207">Link to this property</a>

"NS"

<a href="#(resource)%20email_routing.dns%20%3E%20(model)%20dns_record%20%3E%20(schema)%20%3E%20(property)%20type%20%3E%20(member)%208">Link to this property</a>

"CERT"

<a href="#(resource)%20email_routing.dns%20%3E%20(model)%20dns_record%20%3E%20(schema)%20%3E%20(property)%20type%20%3E%20(member)%209">Link to this property</a>

"DNSKEY"

<a href="#(resource)%20email_routing.dns%20%3E%20(model)%20dns_record%20%3E%20(schema)%20%3E%20(property)%20type%20%3E%20(member)%2010">Link to this property</a>

"DS"

<a href="#(resource)%20email_routing.dns%20%3E%20(model)%20dns_record%20%3E%20(schema)%20%3E%20(property)%20type%20%3E%20(member)%2011">Link to this property</a>

"NAPTR"

<a href="#(resource)%20email_routing.dns%20%3E%20(model)%20dns_record%20%3E%20(schema)%20%3E%20(property)%20type%20%3E%20(member)%2012">Link to this property</a>

"SMIMEA"

<a href="#(resource)%20email_routing.dns%20%3E%20(model)%20dns_record%20%3E%20(schema)%20%3E%20(property)%20type%20%3E%20(member)%2013">Link to this property</a>

"SSHFP"

<a href="#(resource)%20email_routing.dns%20%3E%20(model)%20dns_record%20%3E%20(schema)%20%3E%20(property)%20type%20%3E%20(member)%2014">Link to this property</a>

"SVCB"

<a href="#(resource)%20email_routing.dns%20%3E%20(model)%20dns_record%20%3E%20(schema)%20%3E%20(property)%20type%20%3E%20(member)%2015">Link to this property</a>

"TLSA"

<a href="#(resource)%20email_routing.dns%20%3E%20(model)%20dns_record%20%3E%20(schema)%20%3E%20(property)%20type%20%3E%20(member)%2016">Link to this property</a>

"URI"

<a href="#(resource)%20email_routing.dns%20%3E%20(model)%20dns_record%20%3E%20(schema)%20%3E%20(property)%20type%20%3E%20(member)%2017">Link to this property</a>

</details>

<a href="#(resource)%20email_routing.dns%20%3E%20(model)%20dns_record%20%3E%20(schema)%20%3E%20(property)%20type">Link to this property</a>

</details>

[Link to this property](<#(resource)%20email_routing.dns%20%3E%20(model)%20dns_record%20%3E%20(schema)>)

<details>

<summary>

List\[<a href="https://developers.cloudflare.com/api/python/resources/email_routing#(resource)%20email_routing.dns%20%3E%20(model)%20dns_record%20%3E%20(schema)">DNSRecord</a>]

</summary>

content: Optional\[str]

DNS record content.

<a href="#(resource)%20email_routing.dns%20%3E%20(model)%20dns_record%20%3E%20(schema)%20%3E%20(property)%20content">Link to this property</a>

name: Optional\[str]

DNS record name (or @ for the zone apex).

maxLength255

<a href="#(resource)%20email_routing.dns%20%3E%20(model)%20dns_record%20%3E%20(schema)%20%3E%20(property)%20name">Link to this property</a>

priority: Optional\[float]

Required for MX, SRV and URI records. Unused by other record types. Records with lower priorities are preferred.

maximum65535

minimum0

<a href="#(resource)%20email_routing.dns%20%3E%20(model)%20dns_record%20%3E%20(schema)%20%3E%20(property)%20priority">Link to this property</a>

<details>

<summary>

ttl: Optional\[Union\[float, Literal\[1], null]]

Time to live, in seconds, of the DNS record. Must be between 60 and 86400, or 1 for ‘automatic’.

</summary>

One of the following:

float

<a href="#(resource)%20email_routing.dns%20%3E%20(model)%20dns_record%20%3E%20(schema)%20%3E%20(property)%20ttl%20%3E%20(variant)%200">Link to this property</a>

Literal\[1]

Time to live, in seconds, of the DNS record. Must be between 60 and 86400, or 1 for ‘automatic’.

<a href="#(resource)%20email_routing.dns%20%3E%20(model)%20dns_record%20%3E%20(schema)%20%3E%20(property)%20ttl%20%3E%20(variant)%201">Link to this property</a>

</details>

<a href="#(resource)%20email_routing.dns%20%3E%20(model)%20dns_record%20%3E%20(schema)%20%3E%20(property)%20ttl">Link to this property</a>

<details>

<summary>

type: Optional\[Literal\["A", "AAAA", "CNAME", 15 more]]

DNS record type.

</summary>

One of the following:

"A"

<a href="#(resource)%20email_routing.dns%20%3E%20(model)%20dns_record%20%3E%20(schema)%20%3E%20(property)%20type%20%3E%20(member)%200">Link to this property</a>

"AAAA"

<a href="#(resource)%20email_routing.dns%20%3E%20(model)%20dns_record%20%3E%20(schema)%20%3E%20(property)%20type%20%3E%20(member)%201">Link to this property</a>

"CNAME"

<a href="#(resource)%20email_routing.dns%20%3E%20(model)%20dns_record%20%3E%20(schema)%20%3E%20(property)%20type%20%3E%20(member)%202">Link to this property</a>

"HTTPS"

<a href="#(resource)%20email_routing.dns%20%3E%20(model)%20dns_record%20%3E%20(schema)%20%3E%20(property)%20type%20%3E%20(member)%203">Link to this property</a>

"TXT"

<a href="#(resource)%20email_routing.dns%20%3E%20(model)%20dns_record%20%3E%20(schema)%20%3E%20(property)%20type%20%3E%20(member)%204">Link to this property</a>

"SRV"

<a href="#(resource)%20email_routing.dns%20%3E%20(model)%20dns_record%20%3E%20(schema)%20%3E%20(property)%20type%20%3E%20(member)%205">Link to this property</a>

"LOC"

<a href="#(resource)%20email_routing.dns%20%3E%20(model)%20dns_record%20%3E%20(schema)%20%3E%20(property)%20type%20%3E%20(member)%206">Link to this property</a>

"MX"

<a href="#(resource)%20email_routing.dns%20%3E%20(model)%20dns_record%20%3E%20(schema)%20%3E%20(property)%20type%20%3E%20(member)%207">Link to this property</a>

"NS"

<a href="#(resource)%20email_routing.dns%20%3E%20(model)%20dns_record%20%3E%20(schema)%20%3E%20(property)%20type%20%3E%20(member)%208">Link to this property</a>

"CERT"

<a href="#(resource)%20email_routing.dns%20%3E%20(model)%20dns_record%20%3E%20(schema)%20%3E%20(property)%20type%20%3E%20(member)%209">Link to this property</a>

"DNSKEY"

<a href="#(resource)%20email_routing.dns%20%3E%20(model)%20dns_record%20%3E%20(schema)%20%3E%20(property)%20type%20%3E%20(member)%2010">Link to this property</a>

"DS"

<a href="#(resource)%20email_routing.dns%20%3E%20(model)%20dns_record%20%3E%20(schema)%20%3E%20(property)%20type%20%3E%20(member)%2011">Link to this property</a>

"NAPTR"

<a href="#(resource)%20email_routing.dns%20%3E%20(model)%20dns_record%20%3E%20(schema)%20%3E%20(property)%20type%20%3E%20(member)%2012">Link to this property</a>

"SMIMEA"

<a href="#(resource)%20email_routing.dns%20%3E%20(model)%20dns_record%20%3E%20(schema)%20%3E%20(property)%20type%20%3E%20(member)%2013">Link to this property</a>

"SSHFP"

<a href="#(resource)%20email_routing.dns%20%3E%20(model)%20dns_record%20%3E%20(schema)%20%3E%20(property)%20type%20%3E%20(member)%2014">Link to this property</a>

"SVCB"

<a href="#(resource)%20email_routing.dns%20%3E%20(model)%20dns_record%20%3E%20(schema)%20%3E%20(property)%20type%20%3E%20(member)%2015">Link to this property</a>

"TLSA"

<a href="#(resource)%20email_routing.dns%20%3E%20(model)%20dns_record%20%3E%20(schema)%20%3E%20(property)%20type%20%3E%20(member)%2016">Link to this property</a>

"URI"

<a href="#(resource)%20email_routing.dns%20%3E%20(model)%20dns_record%20%3E%20(schema)%20%3E%20(property)%20type%20%3E%20(member)%2017">Link to this property</a>

</details>

<a href="#(resource)%20email_routing.dns%20%3E%20(model)%20dns_record%20%3E%20(schema)%20%3E%20(property)%20type">Link to this property</a>

</details>

[Link to this property](<#(resource)%20email_routing.dns%20%3E%20(model)%20dns_get_response%20%3E%20(schema)>)