---
title: "Update the email branding settings for an organization"
method: PATCH
path: "/v2/organizations/settings/emailBranding"
tags: ["Organizations"]
---

# Update the email branding settings for an organization

`PATCH /v2/organizations/settings/emailBranding`

## Request

- Base URL: `https://api.sigmacomputing.com`
- URL: `https://api.sigmacomputing.com/v2/organizations/settings/emailBranding`
- Auth: HTTP bearer

Update the email branding settings applied to outgoing emails sent on behalf of the organization.
### Usage notes
- To perform this operation, you must use API credentials owned by a user assigned an account type with the **Manage email branding** permission enabled.
- To read or update this setting for a tenant organization, use [impersonation](/docs/impersonate-users) to obtain a token for that tenant, then call this endpoint with that token.
- `signatureName`, `replyToAddress`, and `globalBccAddresses` can also be updated from the SMTP settings endpoint (`GET`/`PATCH` at `/v2/organizations/settings/smtp`) endpoint. For these fields, the value set most recently from either endpoint is the one used.

## Request body

- object
  - `displayName` string: Display name shown as the email sender ("From" name) on outgoing branded emails.
  - `signatureName` string: Name shown in the signature block of outgoing branded emails.
  - `replyToAddress` string, email, nullable: Reply-to email address for outgoing branded emails. `null` if no reply-to override is configured.
  - `hideSenderInfo` boolean: Whether to hide the sender's name and email address on outgoing branded emails.
  - `globalBccAddresses` string[]: Email addresses that are always bcc'd on outgoing branded emails.
  - `footerBody` string: Footer text appended to outgoing branded emails.

## Response `200`

The response body.

- OrganizationsUpdateEmailBrandingSettingResponse200
  - `displayName` string, required: Display name shown as the email sender ("From" name) on outgoing branded emails.
  - `signatureName` string, required: Name shown in the signature block of outgoing branded emails.
  - `replyToAddress` string, email, nullable, required: Reply-to email address for outgoing branded emails. `null` if no reply-to override is configured.
  - `hideSenderInfo` boolean, required: Whether to hide the sender's name and email address on outgoing branded emails.
  - `globalBccAddresses` string[], required: Email addresses that are always bcc'd on outgoing branded emails.
  - `footerBody` string, required: Footer text appended to outgoing branded emails.

---

[API](https://skmtc.dev/sigmacomputing/apis/sigma-rest-api.md) - [All operations](https://skmtc.dev/sigmacomputing/apis/sigma-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sigmacomputing/apis/sigma-rest-api/revisions/fb6036208c49?raw)