Create Label

Creates a new label available to the team.

POST /inbox/labels

Create Label

cURL

curl --request POST \
  --url https://api.lemlist.com/api/inbox/labels \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "labelName": "Interested"
}
'

200

{
  "_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

200

application/json

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