List Your Connected Mailboxes

GET

https://api.inboxkit.com/v1/api/warmup/external/mailboxes

Maintainer:Not configured

List the mailboxes you connected yourself (Google Workspace, Microsoft 365 and SMTP), newest first. Only connected mailboxes are listed unless you ask for status=disconnected.

Each mailbox has a uid that starts with ext_mbx_. Use it with the warmup endpoints, for example Pause Warmup for Mailboxes or Get Warmup Subscription Details. warmup shows the mailbox's current warmup, or null when it has none.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Query Params

Header Params

Responses

🟢200Success Response

application/json

One page of mailboxes.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🔴500Internal Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.inboxkit.com/v1/api/warmup/external/mailboxes?page=1&limit=10&status=connected&platform=SMTP' \
--header 'X-Workspace-Id;' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Connected mailboxes

{
    "error": false,
    "message": "External mailboxes retrieved successfully",
    "mailboxes": [
        {
            "uid": "ext_mbx_2f8a6c13-9d4e-4b71-8a25-6c3e1f9d7b42",
            "email": "[email protected]",
            "display_name": "Sam Ortiz",
            "platform": "SMTP",
            "connection_type": "smtp",
            "status": "connected",
            "status_reason": null,
            "status_message": null,
            "warmup": {
                "subscription_uid": "ext_sub_8c1e5a94-3f7b-4d26-b9e0-1a6d4c8f2e57",
                "status": "active",
                "health_status": "good"
            },
            "connected_at": "2026-11-04T14:02:10.000Z",
            "disconnected_at": null,
            "created_at": "2026-11-03T09:16:42.000Z"
        },
        {
            "uid": "ext_mbx_7d2c9e41-6b3a-4f80-9c15-2e8a4d6f1b37",
            "email": "[email protected]",
            "display_name": "Dana Reyes",
            "platform": "GOOGLE",
            "connection_type": "oauth",
            "status": "connected",
            "status_reason": null,
            "status_message": null,
            "warmup": {
                "subscription_uid": "ext_sub_4a9f1c62-8e3d-4b57-a0c4-9d2e6f3b8a15",
                "status": "active",
                "health_status": "good"
            },
            "connected_at": "2026-11-03T09:16:42.000Z",
            "disconnected_at": null,
            "created_at": "2026-11-03T09:16:42.000Z"
        }
    ],
    "total": 2,
    "pages": 1,
    "current_page": 1,
    "limit": 10
}

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

Add SMTP Mailboxes

Disconnect a Mailbox