Skip to the documentation
API

Remove an address

Removes the address. It stops receiving, anyone it was shared with loses it, and a sign-in set up for it stops working. Mail it already received stays in the mailbox.

DELETE/domains/{id}/addresses/{addressId}

Runs the real call against your workspace, with your own key.

DELETE /domains/{id}/addresses/{addressId}

Removes the address. It stops receiving, anyone it was shared with loses it, and a sign-in set up for it stops working. Mail it already received stays in the mailbox.

Example

Needs domains:write. A key limited to particular addresses or domains needs to hold the whole domain.

curl
curl -X DELETE "$OE/domains/b3e1f0a4-6c2d-4e8a-9f17-2d5c8a0b4e6f/addresses/5f0c2b7e-8d41-4a6f-b913-7e2a0c4d9b18" -H "$AUTH"
Response
{  "object": "address",  "id": "5f0c2b7e-8d41-4a6f-b913-7e2a0c4d9b18",  "address": "[email protected]",  "deleted": true}

A removed address bounces its mail even while the catch-all is on, so the catch-all never picks it up. Create it again to take mail at it.

Your inbox,
on your own terms.

Email infrastructure for businesses, AI, agents and personal email. Built for scale, privacy and control. Everything email should have had from day one.

OpenEmail

Email infrastructure for businesses, AI, agents and personal email. Built for scale, privacy and control. Everything email should have had from day one.

© 2026 OpenEmail. All rights reserved.