---
title: "Update Email Settings"
method: PUT
path: "/api/v1/admin/email-settings"
tags: ["email-settings"]
---

# Update Email Settings

`PUT /api/v1/admin/email-settings`

Update email settings for the current tenant (admin-only).

If a secret field contains the mask pattern ('****'), the
existing value is preserved. Send a new full value to replace it.

## Headers

- `authorization` string, nullable
- `X-API-Key` string, nullable

## Request body

- EmailSettingsUpdate
  - `enabled` boolean, nullable
  - `provider` string, nullable
  - `from_email` string, nullable
  - `sendgrid_api_key` string, nullable
  - `ses_access_key_id` string, nullable
  - `ses_secret_access_key` string, nullable
  - `ses_region` string, nullable
  - `mass_rate_per_minute` integer, nullable

## Response `200`

Successful Response

- EmailSettingsResponse
  - `enabled` boolean
  - `provider` string
  - `from_email` string
  - `sendgrid_api_key` string
  - `ses_access_key_id` string
  - `ses_secret_access_key` string
  - `ses_region` string
  - `mass_rate_per_minute` integer

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/ninjavan/apis/salesforce-sales-cloud-replacement.md) · [All operations](https://skmtc.net/ninjavan/apis/salesforce-sales-cloud-replacement/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ninjavan/salesforce-sales-cloud-replacement/revisions/fd3a41a6260b/schema)