Skip to main content
DELETE
A category can only be deleted when no lead in any campaign is assigned to it. If it is still in use, the request returns 409 and nothing is deleted. Global (system) categories can never be deleted.

Path Parameters

number
required
The ID of the custom category to delete

Query Parameters

string
required
Your SmartLead API key

Response Codes

Success
Category deleted successfully
Unauthorized
Invalid or missing API key, or the key belongs to a client account
Forbidden
The category is a global (system) category and cannot be deleted
Not Found
No custom category with this ID exists in your account
Conflict
The category is assigned to one or more leads
Internal Server Error
Server error occurred

Usage Notes

To free a category for deletion, set category_id to null on each lead that uses it with Update Lead Category in Campaign. This only removes the category from the lead; the category itself stays until you delete it.
Deleting a category also removes any webhook triggers and CRM category mappings configured for it.