--- title: Email Routing --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Email Routing ##### [Get Email Routing settings](https://developers.cloudflare.com/api/python/resources/email_routing/methods/get) email\_routing.get(EmailRoutingGetParams\*\*kwargs) -> [Settings]() GET/zones/{zone\_id}/email/routing ##### [Update Email Routing settings](https://developers.cloudflare.com/api/python/resources/email_routing/methods/edit) email\_routing.edit(EmailRoutingEditParams\*\*kwargs) -> [Settings]() PATCH/zones/{zone\_id}/email/routing ##### [Apply Email Routing settings](https://developers.cloudflare.com/api/python/resources/email_routing/methods/update) email\_routing.update(EmailRoutingUpdateParams\*\*kwargs) -> [Settings]() PUT/zones/{zone\_id}/email/routing ##### [Disable Email Routing](https://developers.cloudflare.com/api/python/resources/email_routing/methods/disable) Deprecated email\_routing.disable(EmailRoutingDisableParams\*\*kwargs) -> [Settings]() POST/zones/{zone\_id}/email/routing/disable ##### [Enable Email Routing](https://developers.cloudflare.com/api/python/resources/email_routing/methods/enable) Deprecated email\_routing.enable(EmailRoutingEnableParams\*\*kwargs) -> [Settings]() POST/zones/{zone\_id}/email/routing/enable ##### [Unlock Email Routing](https://developers.cloudflare.com/api/python/resources/email_routing/methods/unlock) Deprecated email\_routing.unlock(EmailRoutingUnlockParams\*\*kwargs) -> [Settings]() POST/zones/{zone\_id}/email/routing/unlock ##### ModelsExpand Collapse
class Settings: … id: str Email Routing settings identifier. maxLength32 Link to this property
enabled: Literal\[true, false] State of the zone settings for Email Routing. One of the following: true Link to this property false Link to this property
Link to this property name: str Domain of your zone. Link to this property created: Optional\[datetime] The date and time the settings have been created. formatdate-time Link to this property modified: Optional\[datetime] The date and time the settings have been modified. formatdate-time Link to this property
skip\_wizard: Optional\[Literal\[true, false]] Flag to check if the user skipped the configuration wizard. One of the following: true Link to this property false Link to this property
Link to this property
status: Optional\[Literal\["ready", "unconfigured", "misconfigured", 2 more]] Show the state of your account, and the type or configuration error. One of the following: "ready" Link to this property "unconfigured" Link to this property "misconfigured" Link to this property "misconfigured/locked" Link to this property "unlocked" Link to this property
Link to this property
support\_subaddress: Optional\[Literal\[true, false]] Whether subaddressing (plus-addressing) is honored when matching incoming mail against routing rules. One of the following: true Link to this property false Link to this property
Link to this property Deprecatedtag: Optional\[str] Email Routing settings tag. (Deprecated, replaced by Email Routing settings identifier) maxLength32 Link to this property
[Link to this property](<#(resource)%20email_routing%20%3E%20(model)%20settings%20%3E%20(schema)>) #### Email RoutingDNS ##### [Email Routing - DNS settings](https://developers.cloudflare.com/api/python/resources/email_routing/subresources/dns/methods/get) email\_routing.dns.get(DNSGetParams\*\*kwargs) -> [DNSGetResponse]() 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]() 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]() 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]() DELETE/zones/{zone\_id}/email/routing/dns ##### ModelsExpand Collapse
class DNSRecord: … List of records needed to enable an Email Routing zone. content: Optional\[str] DNS record content. Link to this property name: Optional\[str] DNS record name (or @ for the zone apex). maxLength255 Link to this property priority: Optional\[float] Required for MX, SRV and URI records. Unused by other record types. Records with lower priorities are preferred. maximum65535 minimum0 Link to this property
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’. One of the following: float Link to this property Literal\[1] Time to live, in seconds, of the DNS record. Must be between 60 and 86400, or 1 for ‘automatic’. Link to this property
Link to this property
type: Optional\[Literal\["A", "AAAA", "CNAME", 15 more]] DNS record type. One of the following: "A" Link to this property "AAAA" Link to this property "CNAME" Link to this property "HTTPS" Link to this property "TXT" Link to this property "SRV" Link to this property "LOC" Link to this property "MX" Link to this property "NS" Link to this property "CERT" Link to this property "DNSKEY" Link to this property "DS" Link to this property "NAPTR" Link to this property "SMIMEA" Link to this property "SSHFP" Link to this property "SVCB" Link to this property "TLSA" Link to this property "URI" Link to this property
Link to this property
[Link to this property](<#(resource)%20email_routing.dns%20%3E%20(model)%20dns_record%20%3E%20(schema)>)
List\[DNSRecord] content: Optional\[str] DNS record content. Link to this property name: Optional\[str] DNS record name (or @ for the zone apex). maxLength255 Link to this property priority: Optional\[float] Required for MX, SRV and URI records. Unused by other record types. Records with lower priorities are preferred. maximum65535 minimum0 Link to this property
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’. One of the following: float Link to this property Literal\[1] Time to live, in seconds, of the DNS record. Must be between 60 and 86400, or 1 for ‘automatic’. Link to this property
Link to this property
type: Optional\[Literal\["A", "AAAA", "CNAME", 15 more]] DNS record type. One of the following: "A" Link to this property "AAAA" Link to this property "CNAME" Link to this property "HTTPS" Link to this property "TXT" Link to this property "SRV" Link to this property "LOC" Link to this property "MX" Link to this property "NS" Link to this property "CERT" Link to this property "DNSKEY" Link to this property "DS" Link to this property "NAPTR" Link to this property "SMIMEA" Link to this property "SSHFP" Link to this property "SVCB" Link to this property "TLSA" Link to this property "URI" Link to this property
Link to this property
[Link to this property](<#(resource)%20email_routing.dns%20%3E%20(model)%20dns_get_response%20%3E%20(schema)>) #### Email RoutingRules ##### [List account or zone routing rules](https://developers.cloudflare.com/api/python/resources/email_routing/subresources/rules/methods/list) email\_routing.rules.list(RuleListParams\*\*kwargs) -> SyncV4PagePaginationArray\[[AccountRule]()] GET/{accounts\_or\_zones}/{account\_or\_zone\_id}/email/routing/rules ##### [Get routing rule](https://developers.cloudflare.com/api/python/resources/email_routing/subresources/rules/methods/get) email\_routing.rules.get(strrule\_identifier, RuleGetParams\*\*kwargs) -> [EmailRoutingRule]() GET/zones/{zone\_id}/email/routing/rules/{rule\_identifier} ##### [Create routing rule](https://developers.cloudflare.com/api/python/resources/email_routing/subresources/rules/methods/create) email\_routing.rules.create(RuleCreateParams\*\*kwargs) -> [EmailRoutingRule]() POST/zones/{zone\_id}/email/routing/rules ##### [Update routing rule](https://developers.cloudflare.com/api/python/resources/email_routing/subresources/rules/methods/update) email\_routing.rules.update(strrule\_identifier, RuleUpdateParams\*\*kwargs) -> [EmailRoutingRule]() PUT/zones/{zone\_id}/email/routing/rules/{rule\_identifier} ##### [Delete routing rule](https://developers.cloudflare.com/api/python/resources/email_routing/subresources/rules/methods/delete) email\_routing.rules.delete(strrule\_identifier, RuleDeleteParams\*\*kwargs) -> [EmailRoutingRule]() DELETE/zones/{zone\_id}/email/routing/rules/{rule\_identifier} ##### ModelsExpand Collapse
class Action: … Actions pattern.
type: Literal\["drop", "forward", "worker"] Type of supported action. One of the following: "drop" Link to this property "forward" Link to this property "worker" Link to this property
Link to this property value: Optional\[List\[str]] List of values for the action. Currently limited to a single value. Link to this property
[Link to this property](<#(resource)%20email_routing.rules%20%3E%20(model)%20action%20%3E%20(schema)>)
class EmailRoutingRule: … id: Optional\[str] Routing rule identifier. maxLength32 Link to this property
actions: Optional\[List\[Action]] List actions patterns.
type: Literal\["drop", "forward", "worker"] Type of supported action. One of the following: "drop" Link to this property "forward" Link to this property "worker" Link to this property
Link to this property value: Optional\[List\[str]] List of values for the action. Currently limited to a single value. Link to this property
Link to this property
enabled: Optional\[Literal\[true, false]] Routing rule status. One of the following: true Link to this property false Link to this property
Link to this property
matchers: Optional\[List\[Matcher]] Matching patterns to forward to your actions.
type: Literal\["all", "literal"] Type of matcher. One of the following: "all" Link to this property "literal" Link to this property
Link to this property field: Optional\[Literal\["to"]] Field for type matcher. Link to this property value: Optional\[str] Value for matcher. maxLength90 Link to this property
Link to this property name: Optional\[str] Routing rule name. maxLength256 Link to this property priority: Optional\[float] Priority of the routing rule. minimum0 Link to this property
source: Optional\[Literal\["api", "wrangler"]] Who manages the rule. api covers dashboard, generic API, and Terraform; wrangler means the rule is managed by a Worker’s wrangler.jsonc. Defaults to api when omitted on write. One of the following: "api" Link to this property "wrangler" Link to this property
Link to this property Deprecatedtag: Optional\[str] Routing rule tag. (Deprecated, replaced by routing rule identifier) maxLength32 Link to this property
[Link to this property](<#(resource)%20email_routing.rules%20%3E%20(model)%20email_routing_rule%20%3E%20(schema)>)
class Matcher: … Matching pattern to forward your actions.
type: Literal\["all", "literal"] Type of matcher. One of the following: "all" Link to this property "literal" Link to this property
Link to this property field: Optional\[Literal\["to"]] Field for type matcher. Link to this property value: Optional\[str] Value for matcher. maxLength90 Link to this property
[Link to this property](<#(resource)%20email_routing.rules%20%3E%20(model)%20matcher%20%3E%20(schema)>) #### Email RoutingRulesCatch Alls ##### [Get catch-all rule](https://developers.cloudflare.com/api/python/resources/email_routing/subresources/rules/subresources/catch_alls/methods/get) email\_routing.rules.catch\_alls.get(CatchAllGetParams\*\*kwargs) -> [CatchAllGetResponse]() GET/zones/{zone\_id}/email/routing/rules/catch\_all ##### [Update catch-all rule](https://developers.cloudflare.com/api/python/resources/email_routing/subresources/rules/subresources/catch_alls/methods/update) email\_routing.rules.catch\_alls.update(CatchAllUpdateParams\*\*kwargs) -> [CatchAllUpdateResponse]() PUT/zones/{zone\_id}/email/routing/rules/catch\_all ##### ModelsExpand Collapse
class CatchAllAction: … Action for the catch-all routing rule.
type: Literal\["drop", "forward", "worker"] Type of action for catch-all rule. One of the following: "drop" Link to this property "forward" Link to this property "worker" Link to this property
Link to this property value: Optional\[List\[str]] List of values for the action. Currently limited to a single value. Link to this property
[Link to this property](<#(resource)%20email_routing.rules.catch_alls%20%3E%20(model)%20catch_all_action%20%3E%20(schema)>)
class CatchAllMatcher: … Matcher for catch-all routing rule. type: Literal\["all"] Type of matcher. Default is ‘all’. Link to this property
[Link to this property](<#(resource)%20email_routing.rules.catch_alls%20%3E%20(model)%20catch_all_matcher%20%3E%20(schema)>)
class CatchAllGetResponse: … id: Optional\[str] Routing rule identifier. maxLength32 Link to this property
actions: Optional\[List\[CatchAllAction]] List actions for the catch-all routing rule.
type: Literal\["drop", "forward", "worker"] Type of action for catch-all rule. One of the following: "drop" Link to this property "forward" Link to this property "worker" Link to this property
Link to this property value: Optional\[List\[str]] List of values for the action. Currently limited to a single value. Link to this property
Link to this property
enabled: Optional\[Literal\[true, false]] Routing rule status. One of the following: true Link to this property false Link to this property
Link to this property
matchers: Optional\[List\[CatchAllMatcher]] List of matchers for the catch-all routing rule. type: Literal\["all"] Type of matcher. Default is ‘all’. Link to this property
Link to this property name: Optional\[str] Routing rule name. maxLength256 Link to this property
source: Optional\[Literal\["api", "wrangler"]] Who manages the rule. api covers dashboard, generic API, and Terraform; wrangler means the rule is managed by a Worker’s wrangler.jsonc. Defaults to api when omitted on write. One of the following: "api" Link to this property "wrangler" Link to this property
Link to this property Deprecatedtag: Optional\[str] Routing rule tag. (Deprecated, replaced by routing rule identifier) maxLength32 Link to this property
[Link to this property](<#(resource)%20email_routing.rules.catch_alls%20%3E%20(model)%20catch_all_get_response%20%3E%20(schema)>)
class CatchAllUpdateResponse: … id: Optional\[str] Routing rule identifier. maxLength32 Link to this property
actions: Optional\[List\[CatchAllAction]] List actions for the catch-all routing rule.
type: Literal\["drop", "forward", "worker"] Type of action for catch-all rule. One of the following: "drop" Link to this property "forward" Link to this property "worker" Link to this property
Link to this property value: Optional\[List\[str]] List of values for the action. Currently limited to a single value. Link to this property
Link to this property
enabled: Optional\[Literal\[true, false]] Routing rule status. One of the following: true Link to this property false Link to this property
Link to this property
matchers: Optional\[List\[CatchAllMatcher]] List of matchers for the catch-all routing rule. type: Literal\["all"] Type of matcher. Default is ‘all’. Link to this property
Link to this property name: Optional\[str] Routing rule name. maxLength256 Link to this property
source: Optional\[Literal\["api", "wrangler"]] Who manages the rule. api covers dashboard, generic API, and Terraform; wrangler means the rule is managed by a Worker’s wrangler.jsonc. Defaults to api when omitted on write. One of the following: "api" Link to this property "wrangler" Link to this property
Link to this property Deprecatedtag: Optional\[str] Routing rule tag. (Deprecated, replaced by routing rule identifier) maxLength32 Link to this property
[Link to this property](<#(resource)%20email_routing.rules.catch_alls%20%3E%20(model)%20catch_all_update_response%20%3E%20(schema)>) #### Email RoutingAccount Rules ##### [List account or zone routing rules](https://developers.cloudflare.com/api/python/resources/email_routing/subresources/account_rules/methods/list) email\_routing.account\_rules.list(AccountRuleListParams\*\*kwargs) -> SyncV4PagePaginationArray\[[AccountRule]()] GET/{accounts\_or\_zones}/{account\_or\_zone\_id}/email/routing/rules ##### ModelsExpand Collapse
class AccountRule: … id: Optional\[str] Routing rule identifier. maxLength32 Link to this property
actions: Optional\[List\[Action]] List actions patterns.
type: Literal\["drop", "forward", "worker"] Type of supported action. One of the following: "drop" Link to this property "forward" Link to this property "worker" Link to this property
Link to this property value: Optional\[List\[str]] List of values for the action. Currently limited to a single value. Link to this property
Link to this property
enabled: Optional\[Literal\[true, false]] Routing rule status. One of the following: true Link to this property false Link to this property
Link to this property
matchers: Optional\[List\[Matcher]] Matching patterns to forward to your actions.
type: Literal\["all", "literal"] Type of matcher. One of the following: "all" Link to this property "literal" Link to this property
Link to this property field: Optional\[Literal\["to"]] Field for type matcher. Link to this property value: Optional\[str] Value for matcher. maxLength90 Link to this property
Link to this property name: Optional\[str] Routing rule name. maxLength256 Link to this property priority: Optional\[float] Priority of the routing rule. minimum0 Link to this property
source: Optional\[Literal\["api", "wrangler"]] Who manages the rule. api covers dashboard, generic API, and Terraform; wrangler means the rule is managed by a Worker’s wrangler.jsonc. Defaults to api when omitted on write. One of the following: "api" Link to this property "wrangler" Link to this property
Link to this property Deprecatedtag: Optional\[str] Routing rule tag. (Deprecated, replaced by routing rule identifier) maxLength32 Link to this property
zone: Optional\[Zone] Zone information for the routing rule. name: Optional\[str] Zone name. Link to this property tag: Optional\[str] Zone tag. maxLength32 Link to this property
Link to this property
[Link to this property](<#(resource)%20email_routing.account_rules%20%3E%20(model)%20account_rule%20%3E%20(schema)>) #### Email RoutingAddresses ##### [List destination addresses](https://developers.cloudflare.com/api/python/resources/email_routing/subresources/addresses/methods/list) email\_routing.addresses.list(AddressListParams\*\*kwargs) -> SyncV4PagePaginationArray\[[Address]()] GET/accounts/{account\_id}/email/routing/addresses ##### [Get a destination address](https://developers.cloudflare.com/api/python/resources/email_routing/subresources/addresses/methods/get) email\_routing.addresses.get(strdestination\_address\_identifier, AddressGetParams\*\*kwargs) -> [Address]() GET/accounts/{account\_id}/email/routing/addresses/{destination\_address\_identifier} ##### [Create a destination address](https://developers.cloudflare.com/api/python/resources/email_routing/subresources/addresses/methods/create) email\_routing.addresses.create(AddressCreateParams\*\*kwargs) -> [Address]() POST/accounts/{account\_id}/email/routing/addresses ##### [Update destination address](https://developers.cloudflare.com/api/python/resources/email_routing/subresources/addresses/methods/edit) email\_routing.addresses.edit(strdestination\_address\_identifier, AddressEditParams\*\*kwargs) -> [Address]() PATCH/accounts/{account\_id}/email/routing/addresses/{destination\_address\_identifier} ##### [Delete destination address](https://developers.cloudflare.com/api/python/resources/email_routing/subresources/addresses/methods/delete) email\_routing.addresses.delete(strdestination\_address\_identifier, AddressDeleteParams\*\*kwargs) -> [Address]() DELETE/accounts/{account\_id}/email/routing/addresses/{destination\_address\_identifier} ##### ModelsExpand Collapse
class Address: … id: Optional\[str] Destination address identifier. maxLength32 Link to this property created: Optional\[datetime] The date and time the destination address has been created. formatdate-time Link to this property email: Optional\[str] The contact email address of the user. maxLength90 Link to this property modified: Optional\[datetime] The date and time the destination address was last modified. formatdate-time Link to this property Deprecatedtag: Optional\[str] Destination address tag. (Deprecated, replaced by destination address identifier) maxLength32 Link to this property verified: Optional\[datetime] The date and time the destination address has been verified. Null means not verified yet. formatdate-time Link to this property
[Link to this property](<#(resource)%20email_routing.addresses%20%3E%20(model)%20address%20%3E%20(schema)>)