Skip to main content
POST
This action unsubscribes the lead globally across all campaigns in your account. The lead will not receive any future emails from any campaign. This action cannot be undone via API.

Path Parameters

number
required
The lead ID to unsubscribe globally

Query Parameters

string
required
Your SmartLead API key

Response Codes

Success
Lead unsubscribed successfully
Unauthorized
Invalid or missing API key
Not Found
Lead not found or you don’t have access to it
Internal Server Error
Server error occurred

Behavior Notes

When a lead is globally unsubscribed:
  • The is_unsubscribed flag is set to true on the lead record
  • The lead will not receive emails from any campaign
  • The lead remains in all campaigns but will not be contacted
  • This action affects all current and future campaigns
To unsubscribe a lead from a specific campaign only (not globally), use the campaign-specific unsubscribe endpoint: POST /api/v1/campaigns/{campaign_id}/leads/{lead_id}/unsubscribe