List Labels

GET

/onebox/labels

Labels available on a connected mailbox.

Returns a flat list of label names. Gmail system labels come back lowercased here (inbox, unread, category_updates) even though the same labels appear uppercase on a thread's labels array.

Example

GET /onebox/labels?userId=K5PF9Y068AMDGENV5BTCNJJZK55F&account=andrew.lawyer@aurumlawyer.com

Request

Authorization

API Key

Add parameter in header

cmr-x-api-key

Example:

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

Query Params

Responses

🟢200Success

application/json

Label names on the mailbox.

Bodyapplication/json

🟠401Unauthorized

🟠404Not Found

🟠422Validation Error

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://customers.coldmailreseller.com/api/v1/integration/onebox/labels?userId=K5PF9Y068AMDGENV5BTCNJJZK55F&account=andrew.lawyer%40aurumlawyer.com' \
--header 'cmr-x-api-key: <api-key>'

Response Example

200 - Example 1

{
    "status": 200,
    "message": "Labels fetched",
    "data": [
        "inbox",
        "unread",
        "category_updates"
    ]
}

Modified at 2026-10-02 12:23:00

Act On Thread

Create Label

List Labels

Example#

Request

Responses

Example