Remove Mailboxes Instantly

POST

/v2/mailboxes/remove-mailboxes-instantly

This endpoint is used to instantly remove one or more mailboxes from the system. It supports bulk removal.

Note: Your mailboxes will be deleted immediately, but their slots will remain blocked until their next renewal date. This means you won't be able to create new mailboxes in these slots until the renewal period.

Request

Header Params

Body Params application/json

Example

{
    "mailboxIds": [
        "8c710a22-745f-441b-a225-8cd1f8c8f2b1",
        "620b128a-bf3c-4219-a326-404983140fdd",
        "7dff34a9-fbe5-47dd-8864-4aa13fcf85e1",
        "6dc1cd71-a91d-4afc-ab56-48a7e9b22b75",
        "bf4c4a42-b700-4fe9-aa09-57f2dbd8d5c8",
        "e1389587-a124-4a14-a535-026f3f0854c9",
        "53bdd3fa-cb18-47f5-bb70-ec8adb97779d"
    ],
    "remove": true
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.zapmail.ai/api/v2/mailboxes/remove-mailboxes-instantly' \
--header 'x-auth-zapmail;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "mailboxIds": [
        "8c710a22-745f-441b-a225-8cd1f8c8f2b1",
        "620b128a-bf3c-4219-a326-404983140fdd",
        "7dff34a9-fbe5-47dd-8864-4aa13fcf85e1",
        "6dc1cd71-a91d-4afc-ab56-48a7e9b22b75",
        "bf4c4a42-b700-4fe9-aa09-57f2dbd8d5c8",
        "e1389587-a124-4a14-a535-026f3f0854c9",
        "53bdd3fa-cb18-47f5-bb70-ec8adb97779d"
    ],
    "remove": true
}'

Responses

🟢200Success

application/json

Body

Example

{
    "status": 200,
    "message": "Mailbox will be removed shortly",
    "data": {
        "totalMailboxesQueued": 1
    }
}

🔴500Server Error

Modified at 2025-07-23 13:47:28

Get Authenticator code

Add balance to wallet