Attach Labels to Conversations

Attaches one or more labels to one or more conversations.

POST /inbox/conversations/labels/{contactId}

Attach Labels to Conversations

cURL

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_uPAAgsi4oi9juBHfW",
    "lbl_oZCShmPCP2L43b8qf"
  ],
  "appendLabels": true
}
'

200

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

200

application/json

Success

ok · boolean