# Smartlead Leads API

**Canonical:** https://apis.io/apis/smartlead-ai/smartlead-ai-leads-api/  
**Provider:** Smartlead — https://apis.io/providers/smartlead-ai/  
**Base URL:** https://server.smartlead.ai/api/v1  
**Documentation:** https://api.smartlead.ai/api-reference

Smartlead Leads API is one of 19 APIs that [Smartlead](https://apis.io/providers/smartlead-ai/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Leads. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

Manage leads and prospects across campaigns

## Operations (19)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/campaigns/{campaign_id}/leads` | Get Campaign Leads |
| POST | `/v1/campaigns/{campaign_id}/leads` | Add Leads to Campaign |
| DELETE | `/v1/campaigns/{campaign_id}/leads/{lead_id}` | Delete Lead from Campaign |
| POST | `/v1/campaigns/{campaign_id}/leads/{lead_id}` | Update Lead |
| POST | `/v1/campaigns/{campaign_id}/leads/{lead_id}/pause` | Pause Lead |
| POST | `/v1/campaigns/{campaign_id}/leads/{lead_id}/resume` | Resume Lead |
| POST | `/v1/campaigns/{campaign_id}/leads/{lead_id}/unsubscribe` | Unsubscribe Lead from Campaign |
| POST | `/v1/campaigns/{campaign_id}/leads/{lead_id}/category` | Update Lead Category |
| GET | `/v1/leads/` | Get Lead by Email |
| GET | `/v1/leads/{lead_id}/campaigns` | Get Lead Campaigns |
| GET | `/v1/leads/fetch-categories` | Get Lead Categories |
| POST | `/v1/leads/{lead_id}/unsubscribe` | Unsubscribe Lead Globally |
| POST | `/v1/lead-list/` | Create Lead List |
| GET | `/v1/lead-list/` | Get All Lead Lists |
| GET | `/v1/lead-list/{id}` | Get Lead List by ID |
| PUT | `/v1/lead-list/{id}` | Update Lead List |
| DELETE | `/v1/lead-list/{id}` | Delete Lead List |
| POST | `/v1/lead-list/{id}/import` | Import Leads to List |
| POST | `/v1/lead-list/assign-tags` | Assign Tags to Lead Lists |

## Machine-readable artifacts (3)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/smartlead-ai/refs/heads/main/openapi/smartlead-ai-leads-api-openapi.yml
- **Documentation** — https://api.smartlead.ai/introduction
- **APIReference** — https://api.smartlead.ai/api-reference

## Other Smartlead APIs (12)

- [Smartlead Campaigns API](https://apis.io/apis/smartlead-ai/campaigns-api/)
- [Smartlead Leads API](https://apis.io/apis/smartlead-ai/leads-api/)
- [Smartlead Email Accounts API](https://apis.io/apis/smartlead-ai/email-accounts-api/)
- [Smartlead Email Warmup API](https://apis.io/apis/smartlead-ai/email-warmup-api/)
- [Smartlead Webhooks API](https://apis.io/apis/smartlead-ai/webhooks-api/)
- [Smartlead Analytics API](https://apis.io/apis/smartlead-ai/analytics-api/)
- [Smartlead Client Management API](https://apis.io/apis/smartlead-ai/client-management-api/)
- [Smartlead Campaign Statistics API](https://apis.io/apis/smartlead-ai/smartlead-ai-campaign-statistics-api/)
- [Smartlead Campaigns API](https://apis.io/apis/smartlead-ai/smartlead-ai-campaigns-api/)
- [SmartLead Documentation MCP Server](https://apis.io/apis/smartlead-ai/mcp-server/)
- [Smartlead Analytics API](https://apis.io/apis/smartlead-ai/smartlead-ai-analytics-api/)
- [Smartlead Authentication API](https://apis.io/apis/smartlead-ai/smartlead-ai-authentication-api/)

## Tags

Leads

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/smartlead-ai/smartlead-ai-leads-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/smartlead-ai/.