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"
    }
  ]
}