Skip to main content
GET
/
api
/
v1
/
crm
/
leads
/
tags
curl "https://server.smartlead.ai/api/v1/crm/leads/tags?api_key=YOUR_KEY&leadId=123"

{
  "ok": true,
  "data": [
    {
      "id": 1,
      "tag_mapping_id": 789,
      "name": "VIP",
      "color": "#FF5733"
    },
    {
      "id": 2,
      "tag_mapping_id": 790,
      "name": "Enterprise",
      "color": "#4CAF50"
    }
  ]
}

​
Query Parameters

​
leadId
number
The lead ID to retrieve tags for. If omitted, returns all available tags.
curl "https://server.smartlead.ai/api/v1/crm/leads/tags?api_key=YOUR_KEY&leadId=123"

​
Response Codes

​
200
Success
Request successful
​
400
Bad Request
Invalid request parameters or malformed request body
​
401
Unauthorized
Invalid or missing API key
​
422
Validation Error
Request validation failed. Check parameter types and constraints.
{
  "ok": true,
  "data": [
    {
      "id": 1,
      "tag_mapping_id": 789,
      "name": "VIP",
      "color": "#FF5733"
    },
    {
      "id": 2,
      "tag_mapping_id": 790,
      "name": "Enterprise",
      "color": "#4CAF50"
    }
  ]
}