--- title: Update Email Routing settings --- [Skip to content](#%5Ftop) [API Reference](https://developers.cloudflare.com/api/go) [Email Routing](https://developers.cloudflare.com/api/go/resources/email%5Frouting) Copy Markdown Open in **Claude** Open in **ChatGPT** Open in **Cursor** --- **Copy Markdown** **View as Markdown** # Update Email Routing settings client.EmailRouting.Edit(ctx, params) (\*[Settings](https://developers.cloudflare.com/api/go/resources/email%5Frouting#%28resource%29%20email%5Frouting%20%3E%20%28model%29%20settings%20%3E%20%28schema%29), error) PATCH/zones/{zone\_id}/email/routing Update the settings for your Email Routing zone. ##### Security 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 ZoneID param.Field\[string\] Path param: Identifier. maxLength32 Enabled param.Field\[[EmailRoutingEditParamsEnabled](https://developers.cloudflare.com/api/go/resources/email%5Frouting/methods/edit#%28resource%29%20email%5Frouting%20%3E%20%28method%29%20edit%20%3E%20%28params%29%20default%20%3E%20%28param%29%20enabled%20%3E%20%28schema%29)\]Optional Body param: State of your zone Email Routing settings. No-op on this endpoint - use `POST`/`DELETE /zones/{zone_id}/email/routing/dns`. const EmailRoutingEditParamsEnabledTrue [EmailRoutingEditParamsEnabled](https://developers.cloudflare.com/api/go/resources/email%5Frouting/methods/edit#%28resource%29%20email%5Frouting%20%3E%20%28method%29%20edit%20%3E%20%28params%29%20default%20%3E%20%28param%29%20enabled%20%3E%20%28schema%29) \= true const EmailRoutingEditParamsEnabledFalse [EmailRoutingEditParamsEnabled](https://developers.cloudflare.com/api/go/resources/email%5Frouting/methods/edit#%28resource%29%20email%5Frouting%20%3E%20%28method%29%20edit%20%3E%20%28params%29%20default%20%3E%20%28param%29%20enabled%20%3E%20%28schema%29) \= false SkipWizard param.Field\[[EmailRoutingEditParamsSkipWizard](https://developers.cloudflare.com/api/go/resources/email%5Frouting/methods/edit#%28resource%29%20email%5Frouting%20%3E%20%28method%29%20edit%20%3E%20%28params%29%20default%20%3E%20%28param%29%20skip%5Fwizard%20%3E%20%28schema%29)\]Optional Body param: Flag to check if the user skipped the configuration wizard. const EmailRoutingEditParamsSkipWizardTrue [EmailRoutingEditParamsSkipWizard](https://developers.cloudflare.com/api/go/resources/email%5Frouting/methods/edit#%28resource%29%20email%5Frouting%20%3E%20%28method%29%20edit%20%3E%20%28params%29%20default%20%3E%20%28param%29%20skip%5Fwizard%20%3E%20%28schema%29) \= true const EmailRoutingEditParamsSkipWizardFalse [EmailRoutingEditParamsSkipWizard](https://developers.cloudflare.com/api/go/resources/email%5Frouting/methods/edit#%28resource%29%20email%5Frouting%20%3E%20%28method%29%20edit%20%3E%20%28params%29%20default%20%3E%20%28param%29%20skip%5Fwizard%20%3E%20%28schema%29) \= false SupportSubaddress param.Field\[[EmailRoutingEditParamsSupportSubaddress](https://developers.cloudflare.com/api/go/resources/email%5Frouting/methods/edit#%28resource%29%20email%5Frouting%20%3E%20%28method%29%20edit%20%3E%20%28params%29%20default%20%3E%20%28param%29%20support%5Fsubaddress%20%3E%20%28schema%29)\]Optional Body param: Whether subaddressing (plus-addressing) is honored when matching incoming mail against routing rules. const EmailRoutingEditParamsSupportSubaddressTrue [EmailRoutingEditParamsSupportSubaddress](https://developers.cloudflare.com/api/go/resources/email%5Frouting/methods/edit#%28resource%29%20email%5Frouting%20%3E%20%28method%29%20edit%20%3E%20%28params%29%20default%20%3E%20%28param%29%20support%5Fsubaddress%20%3E%20%28schema%29) \= true const EmailRoutingEditParamsSupportSubaddressFalse [EmailRoutingEditParamsSupportSubaddress](https://developers.cloudflare.com/api/go/resources/email%5Frouting/methods/edit#%28resource%29%20email%5Frouting%20%3E%20%28method%29%20edit%20%3E%20%28params%29%20default%20%3E%20%28param%29%20support%5Fsubaddress%20%3E%20%28schema%29) \= false ##### ReturnsExpand Collapse type Settings struct{…} ID string Email Routing settings identifier. maxLength32 Enabled SettingsEnabled State of the zone settings for Email Routing. One of the following: const SettingsEnabledTrue SettingsEnabled \= true const SettingsEnabledFalse SettingsEnabled \= false Name string Domain of your zone. Created TimeOptional The date and time the settings have been created. formatdate-time Modified TimeOptional The date and time the settings have been modified. formatdate-time SkipWizard SettingsSkipWizardOptional Flag to check if the user skipped the configuration wizard. One of the following: const SettingsSkipWizardTrue SettingsSkipWizard \= true const SettingsSkipWizardFalse SettingsSkipWizard \= false Status SettingsStatusOptional Show the state of your account, and the type or configuration error. One of the following: const SettingsStatusReady SettingsStatus \= "ready" const SettingsStatusUnconfigured SettingsStatus \= "unconfigured" const SettingsStatusMisconfigured SettingsStatus \= "misconfigured" const SettingsStatusMisconfiguredLocked SettingsStatus \= "misconfigured/locked" const SettingsStatusUnlocked SettingsStatus \= "unlocked" SupportSubaddress SettingsSupportSubaddressOptional Whether subaddressing (plus-addressing) is honored when matching incoming mail against routing rules. One of the following: const SettingsSupportSubaddressTrue SettingsSupportSubaddress \= true const SettingsSupportSubaddressFalse SettingsSupportSubaddress \= false DeprecatedTag stringOptional Email Routing settings tag. (Deprecated, replaced by Email Routing settings identifier) maxLength32 ### Update Email Routing settings Go HTTPHTTP TypeScriptTypeScript PythonPython GoGo TerraformTerraform ``` package main import ( "context" "fmt" "github.com/cloudflare/cloudflare-go" "github.com/cloudflare/cloudflare-go/email_routing" "github.com/cloudflare/cloudflare-go/option" ) func main() { client := cloudflare.NewClient( option.WithAPIKey("144c9defac04969c7bfad8efaa8ea194"), option.WithAPIEmail("user@example.com"), ) settings, err := client.EmailRouting.Edit(context.TODO(), email_routing.EmailRoutingEditParams{ ZoneID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"), }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", 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" } } ```