---
title: "Save Email Settings"
method: PUT
path: "/v1/workspaces/{workspace_id}/email-settings"
tags: ["workspaces"]
---

# Save Email Settings

`PUT /v1/workspaces/{workspace_id}/email-settings`

Save the workspace email sender settings and invitation template.

## Path parameters

- `workspace_id` string, uuid, required

## Request body

- WorkspaceEmailSettingsBody — Sender identity + default invitation text for participant emails.
  - `sender_name` string, nullable
  - `sender_email` string, nullable
  - `reply_to` string, nullable
  - `invitation_message` string, nullable
  - `salutation` string, nullable
  - `senders` SenderAddressBody[]
    - `name` string, nullable
    - `email` string, nullable
    - `domain_verified` boolean, nullable
    - `oauth_connection_id` string, nullable
  - `logo_url` string, nullable
  - `privacy_note_enabled` boolean
  - `primary_color` string, nullable
  - `default_sender` string, nullable
  - `active_sender_usable` boolean, nullable
  - `effective_sender` string, nullable

## Response `200`

Successful Response

- WorkspaceEmailSettingsBody — Sender identity + default invitation text for participant emails.
  - `sender_name` string, nullable
  - `sender_email` string, nullable
  - `reply_to` string, nullable
  - `invitation_message` string, nullable
  - `salutation` string, nullable
  - `senders` SenderAddressBody[]
    - `name` string, nullable
    - `email` string, nullable
    - `domain_verified` boolean, nullable
    - `oauth_connection_id` string, nullable
  - `logo_url` string, nullable
  - `privacy_note_enabled` boolean
  - `primary_color` string, nullable
  - `default_sender` string, nullable
  - `active_sender_usable` boolean, nullable
  - `effective_sender` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/ontora/apis/ontora-api.md) · [All operations](https://skmtc.dev/ontora/apis/ontora-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ontora/ontora-api/revisions/7f57037fd94b/schema)