---
title: "Update Email Address"
method: PATCH
path: "/email_addresses/{id}"
tags: ["Email addresses"]
---

# Update Email Address

`PATCH /email_addresses/{id}`

## Request

- Base URL: `https://api.whop.com/api/v1`
- URL: `https://api.whop.com/api/v1/email_addresses/{id}`
- Auth: HTTP bearer

Gives the mailbox to a team member, or shares it with the account, under a new password. A mailbox that had an owner starts empty, because its earlier mail is private to that owner; mail apps sync it again from the start.

## Request body

- object
  - `user_id` string, nullable: ID of the team member who owns the mailbox, prefixed `user_`. Only they can read it or send from it. Leave it out, or pass `null`, to share the mailbox with the account. Giving an owned mailbox to someone else empties it: the owner's mail is never shown to anyone else.

## Response `200`

Email address updated

- EmailAddress
  - `account_id` string, required: ID of the account the address belongs to, prefixed `biz_`.
  - `address` string, required: The full address in lowercase, such as support@example.com.
  - `created_at` string, required: When the address was created, as an ISO 8601 timestamp.
  - `domain_id` string, required: ID of the domain the address is on, prefixed `dom_`.
  - `id` string, required: Email address ID, prefixed `emaddr_`.
  - `password` string, nullable, required: The password mail apps sign in to the mailbox with over IMAP and SMTP, using the address as the username. `null` unless you can use the mailbox: you own it, or nobody owns it and you have `email:read` and `email:send`.
  - `updated_at` string, required: When the address was last updated, as an ISO 8601 timestamp.
  - `user_id` string, nullable, required: ID of the team member who owns the mailbox, prefixed `user_`. Only they can read it or send from it. `null` when the whole account shares it.

## Other responses

- `400`: Invalid Parameters

## Changes

> 118 revisions in range; 1 not diffed.

- **2026-10-20** `ac4774bfce4a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/whop/apis/whop-api/changes/email_addresses/:id/patch.md)

---

[API](https://skmtc.dev/whop/apis/whop-api.md) · [All operations](https://skmtc.dev/whop/apis/whop-api/llms.txt) · [OpenAPI document](https://skmtc.dev/whop/apis/whop-api/revisions/9046948e0ad1?raw)