List Emails

GET

/onebox/threads

The unified inbox feed — threads across every connected mailbox at once.

This is the core Onebox read endpoint. It does not take an account parameter: results span all of the user's connected mailboxes, and each item carries the account it arrived in.

Results are cursor-paginated. Pass the nextCursor from the previous response to fetch the next page; nextCursor is absent on the final page.

Example

GET /onebox/threads?userId=K5PF9Y068AMDGENV5BTCNJJZK55F&limit=10

Request

Authorization

API Key

Add parameter in header

cmr-x-api-key

Example:

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

Query Params

Responses

🟢200Success

application/json

Threads from every connected mailbox, newest first, plus a pagination block.

Bodyapplication/json

🟠401Unauthorized

🟠404Not Found

🟠422Validation Error

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://customers.coldmailreseller.com/api/v1/integration/onebox/threads?userId=K5PF9Y068AMDGENV5BTCNJJZK55F&limit=10&cursor=eyJ0eXBlIjoic2VhcmNoX2FmdGVyIiwidmFsdWVzIjpbMTc5MDk0MDczODAwMCwiMTg3NzkzNzQ3NjczMjU5NjE5MCJdfQ' \
--header 'cmr-x-api-key: <api-key>'

Response Example

200 - Example 1

{
    "status": 200,
    "message": "Threads fetched",
    "data": [
        {
            "threadId": "1877937258181177440",
            "messageId": "<Gq3K93hRllxHkWlnjYO1wg@notifications.google.com>",
            "account": "andrew.lawyer@aurumlawyer.com",
            "date": "2026-10-02T11:34:03.000Z",
            "snippet": "App password created to sign in to your account",
            "subject": "Security alert",
            "from": [
                {
                    "name": "Google",
                    "address": "no-reply@accounts.google.com"
                }
            ],
            "to": [
                {
                    "name": "string",
                    "address": "andrew.lawyer@aurumlawyer.com"
                }
            ],
            "labels": [
                "UNREAD",
                "CATEGORY_UPDATES",
                "INBOX"
            ],
            "folderPath": "inbox",
            "isRead": false,
            "isStarred": false,
            "isWarmUp": false
        }
    ],
    "pagination": {
        "nextCursor": "eyJ0eXBlIjoic2VhcmNoX2FmdGVyIiwidmFsdWVzIjpbMTc5MDk0MDczODAwMCwiMTg3NzkzNzQ3NjczMjU5NjE5MCJdfQ",
        "total": 4
    }
}

Modified at 2026-10-02 13:23:23

List Connected Mailboxes

Get Thread

List Emails

Example#

Request

Responses

Example