Email addresses

Reset Email Address Password

Changed on

Gives the mailbox a new password. Every mail app signed in with the old one loses access. Only the owner can reset an owned mailbox; a shared one needs email:read and email:send.

post/email_addresses/{id}/reset_password

Request

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

Headers

Idempotency-Keystring
Example:d9105228-4a08-46b1-8b91-42fed586d383

A unique key that makes this request safe to retry. See Idempotent requests.

Response

Password reset

account_idstring required

ID of the account the address belongs to, prefixed biz_.

addressstring required

The full address in lowercase, such as support@example.com.

created_atstring required

When the address was created, as an ISO 8601 timestamp.

domain_idstring required

ID of the domain the address is on, prefixed dom_.

idstring required

Email address ID, prefixed emaddr_.

passwordstring 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_atstring required

When the address was last updated, as an ISO 8601 timestamp.

user_idstring 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.

Example response

{
  "account_id": "biz_xxxxxxxxxxxxxx",
  "address": "marcus@shinetime.example",
  "created_at": "2026-01-01T12:00:00.000Z",
  "domain_id": "whopappdomain0000001",
  "id": "emaddr_xxxxxxxxxxxxxx",
  "password": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "updated_at": "2026-01-01T12:00:00.000Z",
  "user_id": "user_xxxxxxxxxxxxxx"
}

Changes