How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Smartlead Leads API

Manage leads and prospects across campaigns

Smartlead Leads API is one of 19 APIs that Smartlead publishes on the 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.

This API exposes 19 operations across 14 paths, and defines 5 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

Requests are made against 2 base URLs: https://server.smartlead.ai/api, https://staging.smartlead.ai/api.

19 operations 14 paths 5 schemas 2 DELETE6 GET10 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Base URL
https://server.smartlead.ai/api/v1
Authentication
API Key
Resource Areas
1

Authentication & Security 1

Smartlead Leads API declares 1 security scheme for authenticating requests. An API key is passed in the query as api_key (ApiKeyAuth). By default, every request must be authenticated.

  • ApiKeyAuth — Your SmartLead API key. You can generate this from your dashboard under Settings API Keys. Include this as a query parameter in all API requests: ?apikey=YOURA…

Paths & Operations 19

Across 14 paths, the API surfaces 19 operations — 2 DELETE, 6 GET, 10 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Leads 19

Manage leads and prospects across campaigns

GET
/v1/campaigns/{campaign_id}/leads
Get Campaign Leads
getCampaignLeads 7 params → 200401404500
POST
/v1/campaigns/{campaign_id}/leads
Add Leads to Campaign
addLeadsToCampaign 2 params body → 200400401422500
DELETE
/v1/campaigns/{campaign_id}/leads/{lead_id}
Delete Lead from Campaign
deleteLeadFromCampaign 3 params → 200401404500
POST
/v1/campaigns/{campaign_id}/leads/{lead_id}
Update Lead
updateLead 3 params body → 200401404422500
POST
/v1/campaigns/{campaign_id}/leads/{lead_id}/pause
Pause Lead
pauseLead 3 params → 200401404500
POST
/v1/campaigns/{campaign_id}/leads/{lead_id}/resume
Resume Lead
resumeLead 3 params → 200401404500
POST
/v1/campaigns/{campaign_id}/leads/{lead_id}/unsubscribe
Unsubscribe Lead from Campaign
unsubscribeLeadFromCampaign 3 params → 200401404500
POST
/v1/campaigns/{campaign_id}/leads/{lead_id}/category
Update Lead Category
updateLeadCategory 3 params body → 200401404500
GET
/v1/leads/
Get Lead by Email
getLeadByEmail 2 params → 200401404500
GET
/v1/leads/{lead_id}/campaigns
Get Lead Campaigns
getLeadCampaigns 2 params → 200401404500
GET
/v1/leads/fetch-categories
Get Lead Categories
getLeadCategories 1 param → 200401500
POST
/v1/leads/{lead_id}/unsubscribe
Unsubscribe Lead Globally
unsubscribeLeadGlobally 2 params → 200401404500
POST
/v1/lead-list/
Create Lead List
createLeadList 1 param body → 200401422500
GET
/v1/lead-list/
Get All Lead Lists
getAllLeadLists 5 params → 200401500
GET
/v1/lead-list/{id}
Get Lead List by ID
getLeadListById 2 params → 200401404500
PUT
/v1/lead-list/{id}
Update Lead List
updateLeadList 2 params body → 200401404422500
DELETE
/v1/lead-list/{id}
Delete Lead List
deleteLeadList 2 params → 200401404500
POST
/v1/lead-list/{id}/import
Import Leads to List
importLeadsToList 2 params body → 200401422500
POST
/v1/lead-list/assign-tags
Assign Tags to Lead Lists
assignTagsToLeadLists 1 param body → 200401422500

Schemas 5

The contract defines 5 schemas that model the data the API accepts and returns. The most detailed are Lead (12 properties), LeadInput (7 properties), LeadList (7 properties), LeadUpdate (6 properties). Each schema is shown below with its type and property counts.

LeadList
object
7 properties
LeadUpdate
object
6 properties
LeadInput
object
7 properties 1 required
LeadCategory
object
3 properties
Lead
object
12 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

smartlead-ai-leads-api-openapi.yml Raw ↑

Other APIs Smartlead publishes across the network.

Smartlead Campaigns API
Smartlead Leads API
Smartlead Email Accounts API
Smartlead Email Warmup API
Smartlead Webhooks API
Smartlead Analytics API
Smartlead Client Management API
Smartlead Campaign Statistics API
Smartlead Campaigns API
SmartLead Documentation MCP Server
Smartlead Analytics API
Smartlead Authentication API
Where this information came from

This is an independent, third-party profile of Smartlead Leads API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.