---
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 or address your app's mail is sent from.

The domain part of `from_email` has to be a domain this app already has set up for email. The call edits that domain's sender details and nothing else, so it never changes which domain your mail goes out from. Use [Replace the email domain](/api-reference/replace-the-email-domain) for that.

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

## 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 has to be one the app already has set up for email. Required, so resend the current value to keep it.

## 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 doesn't change it. Only `active` sends mail. The `pending_` values mean setup is still in progress, and the `failed_` values mean it stopped and you can start it again with [Retry email domain setup](/api-reference/retry-email-domain-setup).

## Other responses

- `401` — Missing or invalid credentials.
- `403` — You don't have access to this app, you used a workspace API key, or the email domain is suspended. A suspended domain says why in the message.
- `404` — The domain in `from_email` isn't set up for email on this app, or the app doesn't exist.
- `422` — The request body is missing a required field or has an invalid value.

---

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