Disconnect a Mailbox

DELETE

https://api.inboxkit.com/v1/api/warmup/external/mailboxes/{uid}

Maintainer:Not configured

Disconnect a mailbox you connected yourself.

Its warmup is stopped and cancelled, so it is not charged again.

Its stored sign-in details are deleted.

The address is freed, so you can connect it again later. Connecting it again starts a new warmup, and its first month is charged again.

To stop warmup but keep the mailbox connected, use Cancel Warmup for Mailboxes instead.

Disconnecting a mailbox that is already disconnected returns 200 with warmup_cancelled: false.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Header Params

Responses

🟢200Success Response

application/json

The mailbox is disconnected.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

🟠409Conflict

🔴500Internal Server Error

🔴502Bad Gateway

Request Example

Shell

JavaScript

Java

Swift

curl --location --request DELETE 'https://api.inboxkit.com/v1/api/warmup/external/mailboxes/ext_mbx_9a6e2c48-4d1b-4f73-b8e5-0c7f3a9d1e26' \
--header 'X-Workspace-Id;' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Disconnected

{
    "error": false,
    "message": "Mailbox disconnected",
    "mailbox": {
        "uid": "ext_mbx_9a6e2c48-4d1b-4f73-b8e5-0c7f3a9d1e26",
        "email": "[email protected]",
        "display_name": "Ana Silva",
        "platform": "SMTP",
        "connection_type": "smtp",
        "status": "disconnected",
        "status_reason": null,
        "status_message": null,
        "warmup": null,
        "connected_at": "2026-11-04T14:02:10.000Z",
        "disconnected_at": "2026-11-20T10:45:31.000Z",
        "created_at": "2026-11-03T09:16:42.000Z"
    },
    "warmup_cancelled": true
}

Modified at 2026-10-22 10:54:10

List Your Connected Mailboxes

List Warmup Subscriptions