Skip to main content

How to set up Smartlead.ai

Authentication

Smartlead uses API key authentication:
  1. Log in to your Smartlead.ai account
  2. Navigate to Settings → API
  3. Generate or copy your API key
  4. Paste the API key in Cargo when connecting

Smartlead actions

Add lead

Add a new lead to a Smartlead campaign. Required fields:
  • Campaign ID: The ID of the campaign to add the lead to
  • Email: Lead’s email address
Optional fields:
  • Mappings: Map standard lead fields:
    • First name
    • Last name
    • Phone number
    • Company name
    • Website
    • Location
    • LinkedIn profile
    • Company URL
  • Custom mappings: Map custom fields for personalization
Use cases:
  • Automatically enroll qualified leads into cold email campaigns
  • Sync leads from your CRM to Smartlead campaigns
  • Add leads based on scoring or segmentation criteria

Pause lead

Temporarily pause a lead in a campaign. Required fields:
  • Campaign ID: The campaign the lead is in
  • Lead ID: The Smartlead lead ID
Use case: Pause outreach when a lead shows engagement or requests to be contacted later.

Resume lead

Resume a paused lead in a campaign. Required fields:
  • Campaign ID: The campaign the lead is in
  • Lead ID: The Smartlead lead ID
Use case: Resume outreach after a specified time or based on a trigger.

Remove lead

Remove a lead from a campaign entirely. Required fields:
  • Campaign ID: The campaign the lead is in
  • Lead ID: The Smartlead lead ID
Use case: Remove leads who have converted, unsubscribed, or no longer match your criteria.

Get campaigns

List every campaign in the Smartlead account, with its ID, name and status. Use case: Loop over campaigns to read their statistics.

Get campaign statistics

Get every email sent in a campaign: the lead, the sequence step, when it was sent, and whether it was opened, clicked, replied or bounced. Required fields:
  • Campaign ID: The campaign to read
Optional fields:
  • Sent after / Sent before: Only emails sent in this date range
  • Sequence step: Only emails from this step (1-20)
  • Email status: Only emails that were opened, clicked, replied, unsubscribed or bounced
  • Limit: Number of emails to return (1-1000, default 100). Narrow the sent dates to read more.
Use case: Backfill send history from before the Listen events extractor was switched on, or report on sends per step.

Field mappings

When adding leads, you can map these standard fields:

Rate limits

Smartlead API has a rate limit of 60 requests per minute. Cargo automatically handles rate limiting to ensure reliable delivery.