Skip to main content
DELETE
/
api
/
v1
/
crm
/
leads
/
tags
/
{tagMappingId}
curl -X DELETE "https://server.smartlead.ai/api/v1/crm/leads/tags/789?api_key=YOUR_KEY"

{
  "ok": true,
  "message": "Tag removed from lead successfully"
}

​
Path Parameters

​
tagMappingId
number
required
The tag mapping ID (not the tag ID). Get this from the Get Lead Tags response.
curl -X DELETE "https://server.smartlead.ai/api/v1/crm/leads/tags/789?api_key=YOUR_KEY"

​
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": "Tag removed from lead successfully"
}