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"
}
]
}
{
"message": "Invalid API Key"
}
Lead Tags
Get Lead Tags
Get tags associated with a specific lead
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"
}
]
}
{
"message": "Invalid API Key"
}
Query Parameters
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
Success
Request successful
Bad Request
Invalid request parameters or malformed request body
Unauthorized
Invalid or missing API key
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"
}
]
}
{
"message": "Invalid API Key"
}