Skip to main content
GET
/
inbox
/
labels
Get Many Labels
curl --request GET \
  --url https://api.lemlist.com/api/inbox/labels \
  --header 'Authorization: Basic <encoded-value>'
[
  {
    "_id": "lbl_3bgE97gvicZ888wz4",
    "name": "Interested",
    "color": "#F9A2A2",
    "createdAt": "2025-11-26T15:49:23.470Z",
    "createdBy": "[email protected]"
  }
]
This endpoint uses the Label object.

Authorizations

Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Response

Success - Returns array of labels

_id
string

Unique label identifier

name
string

Label name

color
string

Hex color code for the label

createdAt
string<date-time> | null

Date and time when the label was created

createdBy
string | null

Email of the user who created the label