Skip to main content
POST
Custom categories belong to your account only. They appear alongside the global categories in Get Lead Categories and can be assigned to leads like any other category.

Query Parameters

string
required
Your SmartLead API key

Body Parameters

string
required
Category name (max 255 characters, surrounding spaces are trimmed). Must not match an existing global or custom category name (case-insensitive).
string | null
Sentiment of the category. Values: positive, negative, or null (neutral). Defaults to null.
string
Hex colour used for the category in the app, e.g. #4CAF50. Defaults to #f9f1e9.

Response Fields

boolean
true when the category was created
object
The created category

Response Codes

Created
Category created successfully
Bad Request
Validation failed: missing name, invalid sentiment_type, or invalid colour_code
Unauthorized
Invalid or missing API key, or the key belongs to a client account
Conflict
A category with this name already exists
Internal Server Error
Server error occurred