---
title: "Delete mailboxes"
method: DELETE
path: "/api/v1/mailboxes"
tags: ["Mailboxes"]
---

# Delete mailboxes

`DELETE /api/v1/mailboxes`

## Request

- Base URL: `https://api.aerosend.io`
- URL: `https://api.aerosend.io/api/v1/mailboxes`
- Auth: API key in header `X-API-Key`

Deletes one or more mailboxes for the authenticated client.

## Deletion Rules
- Only mailboxes with `pending` status can be deleted
- Mailboxes with other statuses are skipped and returned in the response

## Identifiers
- Can delete by mailbox IDs (`ids` array)
- Can delete by email addresses (`emails` array)
- Can use both IDs and emails in the same request
- At least one identifier type must be provided

## Response
- Returns count of successfully deleted mailboxes
- Returns list of skipped mailboxes with reasons

## Request body

- DeleteMailboxesRequest: Request to delete one or more mailboxes
  - `ids` integer[]: List of mailbox IDs to delete
  - `emails` string[]: List of email addresses to delete

## Response `200`

Mailboxes deleted successfully

- DeleteMailboxesApiResponse
  - `success` boolean: Success flag
  - `data` DeleteMailboxesResponse: Response after deleting mailboxes
    - `deleted_count` integer: Number of mailboxes successfully deleted
    - `skipped` SkippedMailbox[]: List of mailboxes that were skipped (not in pending status)
      - `id` integer: Mailbox ID
      - `email` string: Email address
      - `reason` string: Reason for skipping
  - `timestamp` string: Response timestamp

## Other responses

- `400`: Invalid request - missing identifiers
- `401`: Unauthorized - Invalid or expired API key
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/aerosend/apis/aerosend-developer-api.md) · [All operations](https://skmtc.dev/aerosend/apis/aerosend-developer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aerosend/apis/aerosend-developer-api/revisions/9828eeb89b1f?raw)