--- title: Update Email Routing settings --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/typescript) [Email Routing](https://developers.cloudflare.com/api/typescript/resources/email_routing) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Update Email Routing settings client.emailRouting.edit(EmailRoutingEditParams {zone\_id, enabled, skip\_wizard, support\_subaddress } params, RequestOptionsoptions?): [Settings]() {id, enabled, name, 6 more } PATCH/zones/{zone\_id}/email/routing Update the settings for your Email Routing zone. ##### Security
API Token The preferred authorization scheme for interacting with the Cloudflare API. Create a token. **Example:**Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY
API Email + API Key The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key. **Example:**X-Auth-Email: user@example.com The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys. **Example:**X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194
##### Accepted Permissions (at least one required) `Zone Settings Write` ##### ParametersExpand Collapse
params: EmailRoutingEditParams {zone\_id, enabled, skip\_wizard, support\_subaddress } zone\_id: string Path param: Identifier. maxLength32 Link to this property
enabled?: true| false Body param: State of your zone Email Routing settings. No-op on this endpoint - use POST/DELETE /zones/{zone_id}/email/routing/dns. One of the following: true Link to this property false Link to this property
Link to this property
skip\_wizard?: true| false Body param: 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
support\_subaddress?: true| false Body param: 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
[Link to this property](<#(resource)%20email_routing%20%3E%20(method)%20edit%20%3E%20(params)%20default>) ##### ReturnsExpand Collapse
Settings {id, enabled, name, 6 more } id: string Email Routing settings identifier. maxLength32 Link to this property
enabled: 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: string Domain of your zone. Link to this property created?: string The date and time the settings have been created. formatdate-time Link to this property modified?: string The date and time the settings have been modified. formatdate-time Link to this property
skip\_wizard?: 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?: "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?: 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?: string 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)>) ### Update Email Routing settings TypeScript HTTPTypeScriptPythonGoTerraform ``` import Cloudflare from 'cloudflare'; const client = new Cloudflare({ apiToken: process.env['CLOUDFLARE_API_TOKEN'], // This is the default and can be omitted }); const settings = await client.emailRouting.edit({ zone_id: '023e105f4ecef8ad9ca31a8372d0c353' }); console.log(settings.id); ``` 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "success": true, "result": { "id": "75610dab9e69410a82cf7e400a09ecec", "enabled": true, "name": "example.net", "created": "2014-01-02T02:20:00Z", "modified": "2014-01-02T02:20:00Z", "skip_wizard": true, "status": "ready", "support_subaddress": true, "tag": "75610dab9e69410a82cf7e400a09ecec" } } ``` ##### Returns Examples 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "success": true, "result": { "id": "75610dab9e69410a82cf7e400a09ecec", "enabled": true, "name": "example.net", "created": "2014-01-02T02:20:00Z", "modified": "2014-01-02T02:20:00Z", "skip_wizard": true, "status": "ready", "support_subaddress": true, "tag": "75610dab9e69410a82cf7e400a09ecec" } } ```