List Lead Labels

GET

https://api.plusvibe.ai/api/v1/workspace-settings/lead-labels

Lists every lead label available in the workspace: the built-in system labels (Interested, Not Interested, Out Of Office, …) and the workspace's custom labels. Use the key values when configuring ai_lead_labeling.labels or auto_follow_up.labels.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Query Params

Responses

🟢200OK

application/json

Labels

Bodyapplication/json

🟠400Bad Request

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.plusvibe.ai/api/v1/workspace-settings/lead-labels?workspace_id=undefined' \
--header 'x-api-key: <api-key>'

Response Example

200 - Success Example

{
    "id": null,
    "key": "INTERESTED",
    "name": "Interested",
    "sentiment": "POSITIVE",
    "icon": "bi-tag-fill",
    "is_system": 1,
    "is_ai_label": 1
}

Modified at 2026-08-15 09:43:13

Update Workspace Settings

Add Custom Lead Label