Skip to main content
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 - Interested
  • 2 - Meeting Request
  • 3 - Not Interested
  • 4 - Do Not Contact
  • 5 - 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

The email_lead_map_id is returned as campaign_lead_map_id from inbox endpoints:
From inbox response