Mailboxes

Delete mailboxes

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

Request body

idsinteger[]

List of mailbox IDs to delete

emailsstring[]

List of email addresses to delete

Example request

{
  "ids": [
    456,
    789
  ],
  "emails": [
    "john@example.com",
    "jane@example.com"
  ]
}

Response

Mailboxes deleted successfully

successboolean

Success flag

timestampstring

Response timestamp

Example response

{
  "success": true,
  "data": {
    "deleted_count": 3,
    "skipped": []
  },
  "timestamp": "2025-12-14T10:30:00Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.