Lead Management
Get Lead Categories
Retrieve all available lead categories including global and user-specific categories
GET
Returns both global categories (available to all users) and categories you’ve created. Categories are used to organize and filter leads based on their engagement or status.
Query Parameters
string
required
Your SmartLead API key
Response Fields
The response is an array of category objects, each containing:number
Unique category identifier
string
Category name (e.g., “Interested”, “Not Interested”, “Meeting Booked”)
string
Sentiment classification of the category. Values:
positive, negative, neutraltimestamp
ISO 8601 timestamp of when the category was created
Response Codes
Success
Categories retrieved successfully
Unauthorized
Invalid or missing API key
Internal Server Error
Server error occurred
Usage Notes
Categories are sorted by ID in ascending order. Global categories (available to all users) have lower IDs, while user-created categories have higher IDs.
Related Endpoints
- Get Campaign Leads - Filter leads by category
- Get Lead by Email - View lead’s assigned category
