Skip to main content
PATCH
Only custom categories you created can be updated. Global (system) categories such as Interested, Not Interested, or Out Of Office are read-only and return 403.

Path Parameters

number
required
The ID of the custom category to update

Query Parameters

string
required
Your SmartLead API key

Body Parameters

Send at least one field. Only the fields you send are changed.
string
New category name (max 255 characters, surrounding spaces are trimmed). Must not match another global or custom category name (case-insensitive).
string | null
Values: positive, negative, or null (neutral)
string
Hex colour, e.g. #FFC107

Response Fields

boolean
true when the category was updated
object
The updated category, with the same fields as Create Lead Category: id, name, user_id, sentiment_type, colour_code, created_at

Response Codes

Success
Category updated successfully
Bad Request
Validation failed or the body was empty
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 modified
Not Found
No custom category with this ID exists in your account
Conflict
Another category with this name already exists
Internal Server Error
Server error occurred