Skip to main content
DELETE
Delete Email Address

Authorizations

Authorization
string
header
required

An Account API key, an App API key, an account access token, an account-scoped user token, or a user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************. See Auth & API keys for how to get each one.

Headers

Api-Version-Date
string

Pins the request to a dated API version.

Example:

"2026-10-15-1"

Path Parameters

id
string
required

Email address ID, prefixed emaddr_.

Response

200 - application/json

Email address deleted

account_id
string
required

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

Example:

"biz_xxxxxxxxxxxxxx"

address
string
required

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

Example:

"marcus@shinetime.example"

created_at
string
required

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

Example:

"2026-01-01T12:00:00.000Z"

domain_id
string
required

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

Example:

"whopappdomain0000001"

id
string
required

Email address ID, prefixed emaddr_.

Example:

"emaddr_xxxxxxxxxxxxxx"

password
string | null
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.

Example:

"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

updated_at
string
required

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

Example:

"2026-01-01T12:00:00.000Z"

user_id
string | null
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:

"user_xxxxxxxxxxxxxx"