List Connected Mailboxes

GET

/onebox/connected-mailboxes

Every mailbox currently connected to Onebox for a user.

Use this to confirm a connection finished: POST /onebox/connect only queues the work, and a mailbox appears here with status: "active" once it is genuinely usable.

errors is null on a healthy mailbox and carries provider error detail when the connection has gone bad (expired consent, revoked access).

Example

GET /onebox/connected-mailboxes?userId=K5PF9Y068AMDGENV5BTCNJJZK55F

Request

Authorization

API Key

Add parameter in header

cmr-x-api-key

Example:

cmr-x-api-key: ********************

Query Params

Responses

🟢200Success

application/json

Connected mailboxes. Empty array when the user has none.

Bodyapplication/json

🟠401Unauthorized

🟠404Not Found

🟠422Validation Error

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://customers.coldmailreseller.com/api/v1/integration/onebox/connected-mailboxes?userId=K5PF9Y068AMDGENV5BTCNJJZK55F&status=active' \
--header 'cmr-x-api-key: <api-key>'

Response Example

200 - Example 1

{
    "status": 200,
    "message": "Mailboxes fetched",
    "data": [
        {
            "id": 2139960,
            "email": "andrew.lawyer@aurumlawyer.com",
            "firstName": "Andrew",
            "lastName": "Lawyer",
            "provider": "GMAIL",
            "username": "andrew.lawyer@aurumlawyer.com",
            "status": "active",
            "errors": null,
            "createdAt": "2026-10-02T12:07:31.995Z"
        }
    ]
}

Modified at 2026-10-02 12:20:40

Connect Mailbox

List Emails

List Connected Mailboxes

Example#

Request

Responses

Example