---
title: "Update Email Settings"
method: PUT
path: "/workspaces/{workspace_id}/emails/settings"
tags: ["Emails::Settings"]
---

# Update Email Settings

`PUT /workspaces/{workspace_id}/emails/settings`

Update a workspace's email/marketing settings. Most importantly, this sets the marketing (business) address, which is the workspace-wide gate for sending email broadcasts: broadcasts cannot be sent until the address is complete. When an `address` is supplied it is validated for completeness, so a 422 here means the address is still incomplete and broadcasts remain blocked.

## Path parameters

- `workspace_id` integer, required

## Request body

- object
  - `marketing_setting` EmailsSettingsParameters — Email/marketing settings for a workspace
    - `name` string — Business/sender name shown on email broadcasts
    - `address_single_line` boolean — Render the marketing address on a single line
    - `hide_branding` boolean — Hide ClickFunnels branding in the email footer
    - `unsubscribe_footer` string — Custom unsubscribe footer text
    - `footer_alignment` string — Alignment of the email footer
    - `system_emails_from_address_id` integer, nullable — An Emails::Address id used as the from address for system emails
    - `system_emails_reply_to_address_id` integer, nullable — An Emails::Address id used as the reply-to address for system emails
    - `marketing_emails_from_address_id` integer, nullable — An Emails::Address id used as the from address for marketing emails
    - `marketing_emails_reply_to_address_id` integer, nullable — An Emails::Address id used as the reply-to address for marketing emails
    - `address` object — The marketing (business) address. This is the workspace-wide gate for sending email broadcasts: it must be complete before broadcasts can be sent.
      - `address_one` string — Street address line one
      - `address_two` string, nullable — Street address line two
      - `city` string — City
      - `postal_code` string — Postal/ZIP code
      - `country_code` string — ISO 3166-1 alpha-2 country code, e.g. "US"
      - `region` string — State/region by its code (e.g. "CA") or name

## Response `200`

OK

- EmailsSettingsAttributes — Email Settings
  - `workspace_id` integer — Workspace ID
  - `system_emails_from_address` object, nullable — From address for system emails
    - `email_address` string — Email address
    - `name` string, nullable — Display name
  - `system_emails_reply_to_address` object, nullable — Reply-to address for system emails
    - `email_address` string — Email address
    - `name` string, nullable — Display name
  - `marketing_emails_from_address` object, nullable — From address for marketing emails
    - `email_address` string — Email address
    - `name` string, nullable — Display name
  - `marketing_emails_reply_to_address` object, nullable — Reply-to address for marketing emails
    - `email_address` string — Email address
    - `name` string, nullable — Display name
  - `address` object, nullable — The marketing (business) address used on email broadcasts
    - `address_one` string — Street address line one
    - `address_two` string, nullable — Street address line two
    - `city` string — City
    - `postal_code` string — Postal/ZIP code
    - `region_name` string, nullable — State/region name
    - `region` string, nullable — State/region code (e.g. "CA")
    - `country` string, nullable — ISO 3166-1 alpha-2 country code (e.g. "US")
  - `address_complete` boolean — True once the marketing address satisfies the email broadcast gate

## Other responses

- `401` — Unauthorized
- `404` — Not Found
- `422` — Unprocessable Entity

---

[API](https://skmtc.net/myclickfunnels/apis/clickfunnels-api.md) · [All operations](https://skmtc.net/myclickfunnels/apis/clickfunnels-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/myclickfunnels/clickfunnels-api/revisions/ae6313eaa176/schema)