---
title: "Remove an address"
description: "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."
url: "https://openemail.uk/docs/api/domains/addresses/delete"
area: "API"
category: "Mailbox"
---

# 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}`

## 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": "billing@acme.com",
  "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.
