Skip to main content
POST
/
inbox
/
conversations
/
labels
/
{contactId}
Attach Labels to Conversations
curl --request POST \
  --url https://api.lemlist.com/api/inbox/conversations/labels/{contactId} \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "labelIds": [
    "lbl_3bgE97gvicZ888wz4",
    "lbl_5kfD28hvjdA777xy9"
  ],
  "appendLabels": true
}
'
{
  "ok": true
}
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.

Path Parameters

contactId
string
required

Contact ID

Body

application/json
labelIds
string[]
required

Array of label IDs to attach

appendLabels
boolean
required

If true, appends labels to existing ones. If false, replaces all labels.

Response

Success

ok
boolean