Master Inbox
Update Lead Category
Assign or change the category for a lead (Interested, Not Interested, etc.)
PATCH
Categories help organize leads by response type. Common categories: Interested, Not Interested, Meeting Request, Do Not Contact. Get category IDs from the categories endpoint.
Query Parameters
string
required
Your SmartLead API key
Request Body
number
required
The ID of the lead-campaign mapping to update. This is the
campaign_lead_map_id from inbox or campaign leads endpoints.number
required
The category ID to assign. Use
null to remove category assignment.Common Categories:1- Interested2- Meeting Request3- Not Interested4- Do Not Contact5- Information Request- Custom categories (your defined IDs)
Response Codes
Success
Category updated successfully
Unauthorized
Invalid API key
Not Found
Lead mapping not found
Validation Error
Invalid category_id or email_lead_map_id
Common Use Cases
Mark as Interested
Mark as Not Interested
Mark as Meeting Request
Remove Category
Getting email_lead_map_id
Theemail_lead_map_id is returned as campaign_lead_map_id from inbox endpoints:
From inbox response
