curl -X POST "https://server.smartlead.ai/api/v1/lead-list/assign-tags?api_key=YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"listIds": [500, 501], "tagIds": [1, 2], "removeTagIds": [3]}'
{
"ok": true,
"message": "Tags updated successfully"
}
{
"message": "Invalid API Key"
}
Lead Lists
Assign Tags to Lead Lists
Add or remove tags from one or more lead lists
POST
/
api
/
v1
/
lead-list
/
assign-tags
curl -X POST "https://server.smartlead.ai/api/v1/lead-list/assign-tags?api_key=YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"listIds": [500, 501], "tagIds": [1, 2], "removeTagIds": [3]}'
{
"ok": true,
"message": "Tags updated successfully"
}
{
"message": "Invalid API Key"
}
Query Parameters
string
required
Your SmartLead API key
Request Body
array
required
Array of lead list IDs to tag. 1-10 lists allowed.
array
required
Array of tag IDs to assign. 1-10 tags allowed.
array
Array of tag IDs to remove. 1-10 tags allowed.
curl -X POST "https://server.smartlead.ai/api/v1/lead-list/assign-tags?api_key=YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"listIds": [500, 501], "tagIds": [1, 2], "removeTagIds": [3]}'
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,
"message": "Tags updated successfully"
}
{
"message": "Invalid API Key"
}