Skip to main content
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"
}

​
Query Parameters

​
api_key
string
required
Your SmartLead API key

​
Request Body

​
listIds
array
required
Array of lead list IDs to tag. 1-10 lists allowed.
​
tagIds
array
required
Array of tag IDs to assign. 1-10 tags allowed.
​
removeTagIds
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

​
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,
  "message": "Tags updated successfully"
}