---
title: "Update email sender details"
method: PATCH
path: "/api/apps/{app_id}/custom-email-domains"
---

# Update email sender details

`PATCH /api/apps/{app_id}/custom-email-domains`

<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Changes the name and address your app's mail is sent from.

Both fields are required, so send the current value for whichever you are not changing.

`from_email` picks which domain you are editing: its part after the `@` has to be a domain already set up on this app, and you get a 404 when it is not. That means you cannot move to a different domain here, even though this looks like the endpoint that would. Use [Replace the email domain](/api-reference/replace-the-email-domain) for that.

The change applies at once and does not re-run verification, so a domain that was `active` keeps sending.

<Note>This endpoint accepts a personal API key. Workspace API keys are not authorized for it and are rejected with a 403.</Note>

## Path parameters

- `app_id` string, required — ID of the app whose email domains you want to work with.

## Request body

- UpdateEmailDomainRequest — Request to update email domain configuration.
  - `sender_name` string, required — Name recipients see in the From line. Required, so resend the current value to keep it.
  - `from_email` string, email, required — Address mail is sent from. Its domain picks which of the app's email domains you are editing and has to be one already set up.

## Response `200`

The updated sender details.

- UpdateEmailDomainResponse — Response for updating email domain configuration.
  - `sender_name` string, required — The name now in use.
  - `from_email` string, required — The address now in use, lower-cased.
  - `domain` string, required — The domain this configuration belongs to.
  - `configuration_status` string, required — Where setup stands. Updating these fields does not change it.

## Other responses

- `401` — Missing or invalid credentials.
- `403` — You don't have access to this app, the app does not exist, you used a workspace API key, or the domain is suspended.
- `404` — `from_email`'s domain is not set up for email on this app.
- `422` — Validation Error

---

[API](https://skmtc.dev/idealspot/apis/base44-app-management-api.md) · [All operations](https://skmtc.dev/idealspot/apis/base44-app-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/idealspot/base44-app-management-api/revisions/31ef75eb64ab/schema)