Skip to main content
POST
/
inbox
/
labels
Create Label
curl --request POST \
  --url https://api.lemlist.com/api/inbox/labels \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "labelName": "Interested"
}
'
{
  "_id": "lbl_uPAAgsi4oi9juBHfW",
  "name": "Interested",
  "color": "#F9A2A2",
  "createdAt": "2025-11-26T15:49:23.470Z"
}
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.

Body

application/json
​
labelName
string
required

Name of the label to create

Response

Success - Label created

A label used to categorize and organize inbox conversations.

​
_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