Smartlead

List Campaigns

Retrieves all Smartlead campaigns for the authenticated account.

Get Campaign

Retrieves a single Smartlead campaign by ID.

Create Campaign

Creates a Smartlead campaign. The campaign starts in DRAFTED status; add sequences, email accounts, and a schedule before starting it.

Update Campaign Status

Starts, pauses, or stops a Smartlead campaign. START requires the campaign to already have a schedule, sequences, and at least one email account.

Update Campaign Schedule

Sets the sending window, timezone, and throughput limits for a Smartlead campaign. A campaign cannot be started until a schedule exists.

Update Campaign Settings

Updates tracking, stop-on-activity, and sending settings for a Smartlead campaign.

Get Campaign Analytics

Retrieves lifetime performance totals for a Smartlead campaign — sends, opens, clicks, replies, bounces, and lead counts by state.

Get Campaign Analytics by Date

Retrieves Smartlead campaign performance totals for a date range. Smartlead rejects ranges longer than roughly one month.

Get Campaign Sequences

Retrieves the email sequence steps for a Smartlead campaign, including subjects, bodies, and per-step delays.

Save Campaign Sequences

Replaces the email sequence for a Smartlead campaign. Send every step in one call — steps omitted from the request are removed. An empty subject makes a step reply in the previous thread.

Get Campaign Statistics

Retrieves per-email statistics rows for a Smartlead campaign, filterable by sequence step, engagement status, and sent-time range.

Add Leads to Campaign

Adds leads to a Smartlead campaign, up to 400 per call. Returns per-reason counts for leads that were skipped as duplicates, blocked, bounced, or invalid.

List Campaign Leads

Retrieves the leads in a Smartlead campaign with their per-campaign status.

Get Lead by Email

Looks up a Smartlead lead by email address and returns the lead record plus every campaign it belongs to.

Update Lead

Updates a lead in a Smartlead campaign. Smartlead requires the email field even when it is unchanged, and lead edits apply across every campaign the lead belongs to.

Update Lead Category

Sets the category of a lead in a Smartlead campaign, such as Interested or Not Interested. Use List Lead Categories to resolve a category ID.

Pause Lead

Pauses a lead in a Smartlead campaign so it stops receiving sequence emails.

Resume Lead

Resumes a paused lead in a Smartlead campaign, optionally after a delay.

List Lead Categories

Retrieves the lead categories configured on the Smartlead account, with the category IDs needed to categorize a lead.

Get Lead Message History

Retrieves the sent-and-received message history for a lead in a Smartlead campaign.

List Campaign Webhooks

Retrieves the webhooks registered on a Smartlead campaign.

Create or Update Webhook

Creates a webhook on a Smartlead campaign, or updates an existing one when a webhook ID is supplied. Smartlead requires at least one lead category.

Delete Campaign Webhook

Deletes a webhook from a Smartlead campaign.

Get Webhook Summary

Retrieves webhook delivery counts for a Smartlead campaign over a time window, for checking whether events are reaching their destination.

Duplicate Campaign

Copies a Smartlead campaign, including its sequences and settings. The copy is named "<original> - copy" and starts in DRAFTED status.

Delete Campaign

Permanently deletes a Smartlead campaign along with its sequences, leads, and webhooks. This cannot be undone.

Export Campaign Leads (CSV)

Exports every lead in a Smartlead campaign as CSV, including engagement counts and the sequence step last sent to each lead.

List Campaign Email Accounts

Retrieves the sending email accounts attached to a Smartlead campaign.

Add Email Accounts to Campaign

Attaches sending email accounts to a Smartlead campaign. A campaign needs at least one attached account before it can start.

Remove Email Accounts from Campaign

Detaches sending email accounts from a Smartlead campaign.

List Email Accounts

Retrieves the sending email accounts on the Smartlead account, including their IDs for attaching to a campaign.

Get Campaign Lead Statistics

Retrieves per-lead engagement statistics for a Smartlead campaign.

Get Campaign Mailbox Statistics

Retrieves per-mailbox sending statistics for a Smartlead campaign, for spotting which sending accounts are underperforming.

Get Top-Level Analytics by Date

Retrieves top-level Smartlead campaign counts for a date range, including positive replies, skipped, failed, and stopped counts not present in the standard analytics.

List Lead Activities

Retrieves recent lead activity across all Smartlead campaigns — opens, clicks, replies, and status changes. Smartlead exposes no campaign filter on this endpoint.

Get Lead by ID

Looks up a Smartlead lead by its ID.

Unsubscribe Lead from Campaign

Unsubscribes a lead from a single Smartlead campaign, leaving it active in other campaigns.

Unsubscribe Lead Globally

Unsubscribes a lead across every Smartlead campaign and adds it to the account-wide unsubscribe list.

Mark Lead Complete

Marks a lead as completed in a Smartlead campaign so it stops receiving further sequence steps.

Delete Lead from Campaign

Removes a lead from a Smartlead campaign. The lead record itself remains on the account.

List Inbox Replies

Retrieves replies from the Smartlead master inbox across all campaigns, optionally limited to unread replies. Smartlead exposes no campaign filter on this endpoint.

List Lead Lists

Retrieves the lead lists on the Smartlead account with their lead counts.

Get Lead List

Retrieves a single Smartlead lead list by ID.

Create Lead List

Creates a lead list on the Smartlead account.

Update Lead List

Renames a Smartlead lead list.

Delete Lead List

Deletes a Smartlead lead list.

List Clients

Retrieves the clients on a Smartlead agency account, including the client IDs used to scope campaigns and email accounts.