> ## Documentation Index
> Fetch the complete documentation index at: https://developers.arg.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Smartlead

> Run cold outreach - campaigns, leads, replies, and analytics.

Smartlead connects with an API key from your Smartlead settings. It runs cold email outreach: campaigns hold sequences and leads, and the master inbox carries the replies.

## What you can do

**Actions** - list campaigns, read campaign analytics, list campaign leads, find a lead by email, read a lead's conversation, add leads to a campaign, reply to a lead, start / pause / stop a campaign.

**Triggers** - none. Use it through the assistant in chat or as an action node in an automation.

## Get your credential

<Steps>
  <Step title="Open your Smartlead settings">
    Sign in at [app.smartlead.ai](https://app.smartlead.ai/app/settings/profile) and open **Settings**.
  </Step>

  <Step title="Copy the API key">
    One key covers the whole account - Smartlead has no per-key permissions.
  </Step>
</Steps>

## Connect

<Steps>
  <Step title="Open Integrations">
    In arg.ai, go to **Settings → Integrations** and click **Connect** on **Smartlead**.
  </Step>

  <Step title="Paste the key">Enter your API key in the API key field.</Step>
  <Step title="Save">arg.ai verifies it with a single-row read of your email accounts.</Step>
</Steps>

## Use it

* **In chat:** *"Which Smartlead campaign is replying best this month?"*
* **In an automation:** on a schedule, list the leads that replied since the last run and draft an answer for each.

## Finding your way around

Everything is keyed on a campaign id, so start with **List campaigns**. From there:

* **Read campaign analytics** gives sent, opened, clicked and replied counts plus open, click, reply, bounce and unsubscribe rates.
* **List campaign leads** filters by where a lead is in the sequence (`status`) or by engagement (`email_status`, e.g. `is_replied` or `is_bounced`).
* **Find a lead by email** searches the whole account and returns every campaign the lead is in. It answers with an empty object when nothing matches.
* **Add leads to a campaign** imports up to 400 leads per call. Each needs an email; `first_name`, `last_name`, `company_name`, `website`, and `custom_fields` are what the sequence personalizes on.

## Replying keeps the thread

**Reply to a lead** takes the `email_stats_id` of the message you are answering, which comes from **Read a lead's conversation**. That id is what keeps the reply on the existing thread rather than starting a new one, so Smartlead's own tracking continues to follow it.

## Starting and stopping

**Start / pause / stop a campaign** takes `START`, `PAUSED`, or `STOPPED`. Use `START` to begin or resume - a running campaign reads back as `ACTIVE`, but `ACTIVE` is not a value the action accepts, so sending back the status you just read does nothing.