Skip to main content
PATCH
/
api
/
v1
/
master-inbox
/
update-category
curl -X PATCH "https://server.smartlead.ai/api/v1/master-inbox/update-category?api_key=YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email_lead_map_id": 2433664091,
    "category_id": 1
  }'

{
  "success": true,
  "message": "Lead category updated successfully"
}
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

​
api_key
string
required
Your SmartLead API key

​
Request Body

​
email_lead_map_id
number
required
The ID of the lead-campaign mapping to update. This is the campaign_lead_map_id from inbox or campaign leads endpoints.
​
category_id
number
required
The category ID to assign. Use null to remove category assignment.Common Categories:
  • 1 - Interested
  • 2 - Meeting Request
  • 3 - Not Interested
  • 4 - Do Not Contact
  • 5 - Information Request
  • Custom categories (your defined IDs)
curl -X PATCH "https://server.smartlead.ai/api/v1/master-inbox/update-category?api_key=YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email_lead_map_id": 2433664091,
    "category_id": 1
  }'

​
Response Codes

​
200
Success
Category updated successfully
​
401
Unauthorized
Invalid API key
​
404
Not Found
Lead mapping not found
​
422
Validation Error
Invalid category_id or email_lead_map_id
{
  "success": true,
  "message": "Lead category updated successfully"
}

​
Common Use Cases

​
Mark as Interested

update_category(lead_map_id, category_id=1)  # Interested

​
Mark as Not Interested

update_category(lead_map_id, category_id=3)  # Not Interested

​
Mark as Meeting Request

update_category(lead_map_id, category_id=2)  # Meeting Request

​
Remove Category

update_category(lead_map_id, category_id=None)  # Unassign

​
Getting email_lead_map_id

The email_lead_map_id is returned as campaign_lead_map_id from inbox endpoints:
From inbox response
{
  "campaign_lead_map_id": "2433664091",  // Use this as email_lead_map_id
  "lead": {...}
}