> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to Smartlead

The Smartlead connector lets your AI agent act in each user's Smartlead account. Each user connects their own Smartlead API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 30 tools.

**Authentication:** API Key
**Categories:** Marketing, CRM & Sales
**Tools:** 30: 14 read, 12 write, 4 destructive
**Users sign in with:** API key
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=SMARTLEAD)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the Smartlead connection

   In **AgentKit > Connections**, create a Smartlead connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'smartlead'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Smartlead:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'smartlead_campaigns_list',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "smartlead"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Smartlead:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="smartlead_campaigns_list",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their Smartlead credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'smartlead_campaign_analytics_get',
  toolInput: {
    campaign_id: 123,
  },
  connector: 'smartlead',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="smartlead_campaign_analytics_get",
    tool_input={
        "campaign_id": 123,
    },
    connection_name="smartlead",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `smartlead_campaign_analytics_get`

Get Campaign Analytics · Read-only

Get campaign-wide totals for a Smartlead campaign.
Returns totals of emails sent, opened, clicked and replied, and the open, click, reply, bounce and unsubscribe rates.
Use Get Campaign Statistics for per-email rows.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `campaign_id` (`integer`, required): Numeric ID of the Smartlead campaign. Get it from List Campaigns. Example: 123.

Example input: `{"campaign_id":123}`

### `smartlead_campaign_email_accounts_list`

List Campaign Email Accounts · Read-only

List the sending email accounts attached to a Smartlead campaign.
Returns each account's id, from_email, from_name, type and warmup fields.
Use List Email Accounts for every account in the workspace.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `campaign_id` (`integer`, required): Numeric ID of the Smartlead campaign. Get it from List Campaigns. Example: 123.
- `include_tags` (`boolean`, optional): Set true to include email account tags in the response. Example: true.

Example input: `{"campaign_id":123}`

### `smartlead_campaign_get`

Get Campaign · Read-only

Get one Smartlead campaign by ID.
Returns the campaign's id, name, status, client_id, track_settings, stop_lead_settings, sending_limit and lead counts.
Use this when you have the campaign ID. Use List Campaigns to find it.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `campaign_id` (`integer`, required): Numeric ID of the Smartlead campaign. Get it from List Campaigns. Example: 123.
- `include_tags` (`boolean`, optional): Set true to include campaign tags in the response. Example: true.

Example input: `{"campaign_id":123}`

### `smartlead_campaign_lead_message_history_get`

Get Lead Message History · Read-only

Get the email thread between a Smartlead campaign and one lead, sent and received.
Returns the messages exchanged with the lead, each with its subject, direction and timestamps.
Use this to read a lead's replies.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `campaign_id` (`integer`, required): Numeric ID of the Smartlead campaign. Get it from List Campaigns. Example: 123.
- `lead_id` (`integer`, required): Numeric ID of the lead. Get it from List Campaign Leads or Get Lead by Email. Example: 456.
- `event_time_gt` (`string`, optional): Only messages after this ISO 8601 date-time. Example: 2026-01-01T00:00:00Z.
- `show_plain_text_response` (`boolean`, optional): Set true to include the plain-text version of each email. Example: true.

Example input: `{"campaign_id":123,"lead_id":456}`

### `smartlead_campaign_leads_list`

List Campaign Leads · Read-only

List the leads in a Smartlead campaign, filterable by status, category, engagement and dates.
Returns the total and a page of leads, each with id, email, name, company, status, category, last sent time and custom fields.
Use Get Lead by Email to find one lead across all campaigns.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `campaign_id` (`integer`, required): Numeric ID of the Smartlead campaign. Get it from List Campaigns. Example: 123.
- `created_at_gt` (`string`, optional): Only leads added after this ISO 8601 date-time. Example: 2026-01-01T00:00:00Z.
- `email_status` (`string`, optional): Email engagement filter: is_opened, is_clicked, is_bounced, is_replied, is_unsubscribed, is_spam, is_accepted, not_replied or is_sender_bounced. Example: is_replied. One of: `is_opened`, `is_clicked`, `is_bounced`, `is_replied`, `is_unsubscribed`, `is_spam`, `is_accepted`, `not_replied`, `is_sender_bounced`.
- `event_time_gt` (`string`, optional): Only leads whose last event is after this ISO 8601 date-time. Example: 2026-01-01T00:00:00Z.
- `last_sent_time_gt` (`string`, optional): Only leads last emailed after this ISO 8601 date-time. Example: 2026-01-01T00:00:00Z.
- `lead_category_id` (`integer`, optional): Only leads in this category. Get IDs from List Lead Categories. Example: 1.
- `limit` (`integer`, optional): Records per page, 1 to 100. Smartlead defaults to 100. Example: 50.
- `offset` (`integer`, optional): Number of records to skip, for paging. Smartlead defaults to 0. Example: 100.
- `status` (`string`, optional): Lead status: STARTED, INPROGRESS, COMPLETED, PAUSED or STOPPED. Example: INPROGRESS. One of: `STARTED`, `INPROGRESS`, `COMPLETED`, `PAUSED`, `STOPPED`.

Example input: `{"campaign_id":123}`

### `smartlead_campaign_sequences_get`

Get Campaign Sequences · Read-only

Get the email sequence steps of a Smartlead campaign.
Returns each step's id, seq_number, subject, email_body and sequence_variants.
Use this before Save Campaign Sequences to keep existing step IDs.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `campaign_id` (`integer`, required): Numeric ID of the Smartlead campaign. Get it from List Campaigns. Example: 123.

Example input: `{"campaign_id":123}`

### `smartlead_campaign_statistics_get`

Get Campaign Statistics · Read-only

List per-email send statistics of a Smartlead campaign, filterable by sequence step, engagement status and send date.
Returns the campaign's email engagement statistics (opens, clicks, replies, bounces, unsubscribes) for the chosen page and filters.
Use Get Campaign Analytics for campaign-wide totals.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `campaign_id` (`integer`, required): Numeric ID of the Smartlead campaign. Get it from List Campaigns. Example: 123.
- `email_sequence_number` (`integer`, optional): Only return emails from this sequence step (1 to 20). Example: 1.
- `email_status` (`string`, optional): Only return emails with this engagement: opened, clicked, replied, unsubscribed or bounced. Example: replied. One of: `opened`, `clicked`, `replied`, `unsubscribed`, `bounced`.
- `limit` (`integer`, optional): Records per page, 1 to 100. Smartlead defaults to 100. Example: 50.
- `offset` (`integer`, optional): Number of records to skip, for paging. Smartlead defaults to 0. Example: 100.
- `sent_time_end_date` (`string`, optional): Only return emails sent on or before this ISO 8601 date-time. Example: 2026-01-31T23:59:59Z.
- `sent_time_start_date` (`string`, optional): Only return emails sent on or after this ISO 8601 date-time. Example: 2026-01-01T00:00:00Z.

Example input: `{"campaign_id":123}`

### `smartlead_campaign_webhooks_list`

List Campaign Webhooks · Read-only

List the webhooks configured on a Smartlead campaign.
Returns each webhook's id, name, webhook_url and event_types.
Use Save Campaign Webhook to add or change one.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `campaign_id` (`integer`, required): Numeric ID of the Smartlead campaign. Get it from List Campaigns. Example: 123.

Example input: `{"campaign_id":123}`

### `smartlead_campaigns_list`

List Campaigns · Read-only

List all email campaigns in the Smartlead account, optionally for one client.
Returns each campaign's id, name, status, created_at and client_id.
Use this to find a campaign ID. Use Get Campaign for one campaign.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `client_id` (`integer`, optional): Only return campaigns for this client (agency accounts). Example: 42.
- `include_tags` (`boolean`, optional): Set true to include campaign tags in the response. Example: true.

Example input: `{}`

### `smartlead_email_account_get`

Get Email Account · Read-only

Get one Smartlead sending email account by ID.
Returns the account's from_name, from_email, type, SMTP and IMAP settings and status, message_per_day, daily_sent_count and warmup_details.
Use Get Email Account Warmup Stats for warmup performance.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `email_account_id` (`integer`, required): Numeric ID of the sending email account. Get it from List Email Accounts. Example: 789.
- `fetch_campaigns` (`boolean`, optional): Set true to include the IDs of campaigns using this account. Example: true.

Example input: `{"email_account_id":789}`

### `smartlead_email_account_warmup_stats_get`

Get Email Account Warmup Stats · Read-only

Get the last 7 days of warmup statistics for a Smartlead email account.
Returns total_sent, spam_count, reputation_score and daily_stats.
Use this to judge sender reputation before adding an account to a campaign.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `email_account_id` (`integer`, required): Numeric ID of the sending email account. Get it from List Email Accounts. Example: 789.

Example input: `{"email_account_id":789}`

### `smartlead_email_accounts_list`

List Email Accounts · Read-only

List the sending email accounts in the Smartlead workspace, filterable by warmup, connection, provider and usage.
Returns each account's id, from_name, from_email, type, message_per_day, SMTP and IMAP status and warmup details.
Use List Campaign Email Accounts for the accounts on one campaign.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `client_id` (`integer`, optional): Only accounts of this client (agency accounts). Example: 42.
- `email_warmup_status` (`string`, optional): Warmup status: ACTIVE or INACTIVE. Example: ACTIVE. One of: `ACTIVE`, `INACTIVE`.
- `esp` (`string`, optional): Email provider: GMAIL, OUTLOOK or SMTP. Example: GMAIL. One of: `GMAIL`, `OUTLOOK`, `SMTP`.
- `fetch_campaigns` (`string`, optional): true to add the campaign_ids each account is used in. Example: true. One of: `true`, `false`.
- `is_in_use` (`string`, optional): true for accounts used in campaigns, false for unused ones. Example: true. One of: `true`, `false`.
- `is_smtp_success` (`string`, optional): true for accounts whose SMTP connection works, false for failed ones. Example: false. One of: `true`, `false`.
- `is_warmup_blocked` (`string`, optional): true for accounts whose warmup is blocked. Example: true. One of: `true`, `false`.
- `limit` (`integer`, optional): Records per page, 1 to 100. Smartlead defaults to 100. Example: 50.
- `offset` (`integer`, optional): Number of records to skip, for paging. Smartlead defaults to 0. Example: 100.
- `username` (`string`, optional): Partial match on the account's email username. Example: sales.

Example input: `{}`

### `smartlead_lead_categories_list`

List Lead Categories · Read-only

List the global and custom lead categories in the Smartlead account.
Returns each category's id, name and sentiment_type.
Use this to get a category_id for Update Campaign Lead Category and List Campaign Leads.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `smartlead_lead_get_by_email`

Get Lead by Email · Read-only

Find a Smartlead lead by email address across all campaigns.
Returns the lead's id, name, email, company, custom fields, is_unsubscribed and lead_campaign_data listing its campaigns and categories.
Use this to get a lead ID for the campaign lead tools.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `email` (`string`, required): Email address of the lead. Example: jane@acme.com.

Example input: `{"email":"<email>"}`

### `smartlead_campaign_create`

Create Campaign · Write

Create a new Smartlead campaign in DRAFTED status with a name and optional client.
Returns the new campaign's id, name and created_at.
Next, add sequences with Save Campaign Sequences, attach senders with Add Campaign Email Accounts, add leads with Add Leads to Campaign, then start it with Update Campaign Status.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `client_id` (`integer`, optional): Client to own the campaign, for agency accounts. Example: 42.
- `name` (`string`, optional): Campaign name. Smartlead uses "Untitled Campaign" if omitted. Example: Q1 Outbound.

Example input: `{}`

### `smartlead_campaign_email_accounts_add`

Add Campaign Email Accounts · Write

Attach sending email accounts to a Smartlead campaign.
Returns a success flag.
Use List Email Accounts to find account IDs.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `campaign_id` (`integer`, required): Numeric ID of the Smartlead campaign. Get it from List Campaigns. Example: 123.
- `email_account_ids` (`array`, required): IDs of the email accounts to attach. Get them from List Email Accounts. Example: [456, 457].

Example input: `{"campaign_id":123,"email_account_ids":[456,457]}`

### `smartlead_campaign_lead_category_update`

Update Campaign Lead Category · Write

Set or clear a lead's category (such as Interested or Not Interested) in a Smartlead campaign, optionally pausing the lead.
Returns a success flag.
Use List Lead Categories to find category IDs.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `campaign_id` (`integer`, required): Numeric ID of the Smartlead campaign. Get it from List Campaigns. Example: 123.
- `lead_id` (`integer`, required): Numeric ID of the lead. Get it from List Campaign Leads or Get Lead by Email. Example: 456.
- `category_id` (`integer`, optional): Category to assign. Leave empty to clear the category. Get IDs from List Lead Categories. Example: 1.
- `pause_lead` (`boolean`, optional): Set true to also pause the lead's sequence. Smartlead defaults to false. Example: true.

Example input: `{"campaign_id":123,"lead_id":456}`

### `smartlead_campaign_lead_pause`

Pause Campaign Lead · Write

Pause one lead's email sequence in a Smartlead campaign.
Returns a success flag.
Use Resume Campaign Lead to continue it later.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `campaign_id` (`integer`, required): Numeric ID of the Smartlead campaign. Get it from List Campaigns. Example: 123.
- `lead_id` (`integer`, required): Numeric ID of the lead. Get it from List Campaign Leads or Get Lead by Email. Example: 456.

Example input: `{"campaign_id":123,"lead_id":456}`

### `smartlead_campaign_lead_resume`

Resume Campaign Lead · Write

Resume a paused lead's email sequence in a Smartlead campaign, optionally after a delay.
Returns a success flag.
The next email goes out the given number of days after the last one, or after the sequence's own delay.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `campaign_id` (`integer`, required): Numeric ID of the Smartlead campaign. Get it from List Campaigns. Example: 123.
- `lead_id` (`integer`, required): Numeric ID of the lead. Get it from List Campaign Leads or Get Lead by Email. Example: 456.
- `resume_lead_with_delay_days` (`integer`, optional): Days to wait after the last sent email before the next one. Defaults to the sequence's delay. Example: 2.

Example input: `{"campaign_id":123,"lead_id":456}`

### `smartlead_campaign_lead_unsubscribe`

Unsubscribe Campaign Lead · Write

Unsubscribe a lead from one Smartlead campaign so it gets no more emails from it.
Returns a success flag.
This affects only this campaign.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `campaign_id` (`integer`, required): Numeric ID of the Smartlead campaign. Get it from List Campaigns. Example: 123.
- `lead_id` (`integer`, required): Numeric ID of the lead. Get it from List Campaign Leads or Get Lead by Email. Example: 456.

Example input: `{"campaign_id":123,"lead_id":456}`

### `smartlead_campaign_lead_update`

Update Campaign Lead · Write

Update a lead's contact details and custom fields in a Smartlead campaign.
Returns a success flag.
The lead's email is always required, even if unchanged. Custom fields merge with the existing ones.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `campaign_id` (`integer`, required): Numeric ID of the Smartlead campaign. Get it from List Campaigns. Example: 123.
- `email` (`string`, required): The lead's email address. Required even when not changing it. Example: jane@acme.com.
- `lead_id` (`integer`, required): Numeric ID of the lead. Get it from List Campaign Leads or Get Lead by Email. Example: 456.
- `company_name` (`string`, optional): Company name of the lead. Example: Acme Inc.
- `company_url` (`string`, optional): Company URL of the lead. Example: https://acme.com.
- `custom_fields` (`object`, optional): Custom field values to merge into the lead's existing ones, up to 200 keys. Example: {"job_title": "CTO"}.
- `first_name` (`string`, optional): First name of the lead. Example: Jane.
- `last_name` (`string`, optional): Last name of the lead. Example: Doe.
- `linkedin_profile` (`string`, optional): LinkedIn profile URL of the lead. Example: https://www.linkedin.com/in/janedoe.
- `location` (`string`, optional): Location of the lead. Example: Austin, TX.
- `phone_number` (`string`, optional): Phone number of the lead. Example: +15551234567.
- `website` (`string`, optional): Company website of the lead. Example: acme.com.

Example input: `{"campaign_id":123,"email":"<email>","lead_id":456}`

### `smartlead_campaign_leads_add`

Add Leads to Campaign · Write

Import up to 400 leads into a Smartlead campaign, with block-list and duplicate checks.
Returns counts of added and skipped leads and, when settings.return_lead_ids is true, the new lead IDs.
If the campaign is running, new leads enter the sequence and get emailed.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `campaign_id` (`integer`, required): Numeric ID of the Smartlead campaign. Get it from List Campaigns. Example: 123.
- `lead_list` (`array`, required): Leads to import, at most 400. Each needs an email and can have first_name, last_name, company_name, phone_number, website, location, linkedin_profile, company_url and a custom_fields object of up to 200 keys. Example: [{"email": "jane@acme.com", "first_name": "Jane", "company_name": "Acme Inc", "custom_fields": {"job_title": "CEO"}}].
- `settings` (`object`, optional): Import checks. ignore_global_block_list, ignore_unsubscribe_list, ignore_duplicate_leads_in_other_campaign and ignore_community_bounce_list each skip one check (all default false); return_lead_ids returns the new lead IDs. Example: {"ignore_duplicate_leads_in_other_campaign": false, "return_lead_ids": true}.

Example input: `{"campaign_id":123,"lead_list":[{"email":"jane@acme.com","first_name":"Jane","company_name":"Acme Inc","custom_fields":{"job_title":"CEO"}}]}`

### `smartlead_campaign_sequences_save`

Save Campaign Sequences · Write

Create or replace the email sequence steps of a Smartlead campaign.
Returns a success flag.
Pass the full list of steps: a step with an id updates it, a step with id null creates it. Use Get Campaign Sequences first to keep existing step IDs.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `campaign_id` (`integer`, required): Numeric ID of the Smartlead campaign. Get it from List Campaigns. Example: 123.
- `sequences` (`array`, required): Sequence steps. Each step has a seq_number (1 for the first email), a subject (empty to reply in the same thread), an HTML email_body that can use {{first_name}}-style lead variables, seq_delay_details with delay_in_days after the previous step, and an id (null for a new step). Example: [{"id": null, "seq_number": 1, "subject": "Hello {{first_name}}", "email_body": "Hi {{first_name}},
", "seq_delay_details": {"delay_in_days": 0}}].

Example input: `{"campaign_id":123,"sequences":[{"id":null,"seq_number":1,"subject":"Hello {{first_name}}","email_body":"<p>Hi {{first_name}},</p>","seq_delay_details":{"delay_in_days":0}}]}`

### `smartlead_campaign_settings_update`

Update Campaign Settings · Write

Update a Smartlead campaign's name, tracking, stop-lead rule, plain-text options, follow-up percentage, unsubscribe text and out-of-office handling.
Returns a success flag.
Only the fields you pass change. Use Update Campaign Status to start or pause the campaign.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `campaign_id` (`integer`, required): Numeric ID of the Smartlead campaign. Get it from List Campaigns. Example: 123.
- `add_unsubscribe_tag` (`boolean`, optional): Set true to add an unsubscribe tag to outgoing emails. Example: true.
- `auto_pause_domain_leads_on_reply` (`boolean`, optional): Set true so that when a lead replies, other leads in the campaign with the same company e-mail domain are paused. Personal domains such as gmail.com are never matched. Example: true.
- `client_id` (`integer`, optional): Client to assign the campaign to, for agency accounts. Example: 42.
- `enable_ai_esp_matching` (`boolean`, optional): Set true to let Smartlead match each lead with the best sending account by email provider. Example: true.
- `follow_up_percentage` (`integer`, optional): Share of daily sending capacity for follow-ups versus new leads, 0 to 100. Example: 40.
- `force_plain_text` (`boolean`, optional): Set true to convert all emails to plain text. Example: true.
- `name` (`string`, optional): New campaign name. Example: Q1 Outbound v2.
- `out_of_office_detection_settings` (`object`, optional): Out-of-office handling. ignoreOOOasReply keeps the sequence going on an out-of-office reply, autoReactivateOOO resumes the lead afterwards, reactivateOOOwithDelay sets the days to wait, autoCategorizeOOO lets AI categorise such replies. Example: {"ignoreOOOasReply": true, "autoReactivateOOO": true, "reactivateOOOwithDelay": 3, "autoCategorizeOOO": true}.
- `send_as_plain_text` (`boolean`, optional): Set true to send emails as plain text without HTML. Example: true.
- `stop_lead_settings` (`string`, optional): When to stop emailing a lead besides a reply: CLICK_ON_A_LINK or OPEN_AN_EMAIL. Example: CLICK_ON_A_LINK. One of: `CLICK_ON_A_LINK`, `OPEN_AN_EMAIL`.
- `track_settings` (`array`, optional): Tracking to turn off, as a list of DONT_TRACK_EMAIL_OPEN, DONT_TRACK_LINK_CLICK and DONT_TRACK_REPLY_TO_AN_EMAIL. Pass an empty list to track everything. Example: ["DONT_TRACK_EMAIL_OPEN"].
- `unsubscribe_text` (`string`, optional): Unsubscribe text appended to emails. Example: Reply STOP to unsubscribe.

Example input: `{"campaign_id":123}`

### `smartlead_campaign_status_update`

Update Campaign Status · Write

Start, pause, stop or archive a Smartlead campaign.
Returns a success flag and message.
START begins sending to leads, so the campaign needs sequences, email accounts and leads first. STOPPED is permanent; use PAUSED to halt temporarily.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `campaign_id` (`integer`, required): Numeric ID of the Smartlead campaign. Get it from List Campaigns. Example: 123.
- `status` (`string`, required): New status: START to start or resume sending, PAUSED to pause, STOPPED to stop permanently, ARCHIVED to archive. Example: PAUSED. One of: `START`, `PAUSED`, `STOPPED`, `ARCHIVED`.

Example input: `{"campaign_id":123,"status":"START"}`

### `smartlead_campaign_webhook_save`

Save Campaign Webhook · Write

Create or update a webhook on a Smartlead campaign that posts lead events to a URL.
Returns the saved webhook with its id.
Leave webhook_id empty to create; pass it to update an existing webhook from List Campaign Webhooks.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `campaign_id` (`integer`, required): Numeric ID of the Smartlead campaign. Get it from List Campaigns. Example: 123.
- `event_types` (`array`, required): Events that trigger the webhook, such as LEAD_REPLIED, LEAD_OPENED, LEAD_CLICKED, LEAD_BOUNCED and LEAD_UNSUBSCRIBED. Example: ["LEAD_REPLIED", "LEAD_OPENED"].
- `name` (`string`, required): Webhook name. Example: CRM Integration.
- `webhook_url` (`string`, required): HTTPS URL that receives the event POSTs. Example: https://crm.example.com/smartlead-webhook.
- `webhook_id` (`integer`, optional): ID of the webhook to update. Leave empty to create a new one. Example: 456.

Example input: `{"campaign_id":123,"event_types":["LEAD_REPLIED","LEAD_OPENED"],"name":"<name>","webhook_url":"<webhook_url>"}`

### `smartlead_campaign_delete`

Delete Campaign · Destructive

Permanently delete a Smartlead campaign with its sequences, lead associations, statistics, webhooks and email history.
Returns a success flag.
This cannot be undone. To keep the data, use Update Campaign Status with ARCHIVED instead.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `campaign_id` (`integer`, required): Numeric ID of the Smartlead campaign. Get it from List Campaigns. Example: 123.

Example input: `{"campaign_id":123}`

### `smartlead_campaign_email_accounts_remove`

Remove Campaign Email Accounts · Destructive

Detach sending email accounts from a Smartlead campaign. The accounts themselves are kept.
Returns a success flag.
Use List Campaign Email Accounts to find the attached account IDs.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `campaign_id` (`integer`, required): Numeric ID of the Smartlead campaign. Get it from List Campaigns. Example: 123.
- `email_account_ids` (`array`, required): IDs of the email accounts to detach. Get them from List Email Accounts. Example: [456, 457].

Example input: `{"campaign_id":123,"email_account_ids":[456,457]}`

### `smartlead_campaign_lead_delete`

Delete Campaign Lead · Destructive

Remove a lead from a Smartlead campaign, stopping its sequence there.
Returns a success flag.
The lead stays in other campaigns. Use Pause Campaign Lead to stop temporarily instead.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `campaign_id` (`integer`, required): Numeric ID of the Smartlead campaign. Get it from List Campaigns. Example: 123.
- `lead_id` (`integer`, required): Numeric ID of the lead. Get it from List Campaign Leads or Get Lead by Email. Example: 456.

Example input: `{"campaign_id":123,"lead_id":456}`

### `smartlead_campaign_webhook_delete`

Delete Campaign Webhook · Destructive

Delete a webhook from a Smartlead campaign.
Returns a success flag.
Use List Campaign Webhooks to find the webhook ID.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `campaign_id` (`integer`, required): Numeric ID of the Smartlead campaign. Get it from List Campaigns. Example: 123.
- `webhook_id` (`integer`, required): ID of the webhook to delete. Get it from List Campaign Webhooks. Example: 456.

Example input: `{"campaign_id":123,"webhook_id":456}`

## Related

Other Marketing connectors ([all 190](/agentkit/connectors/?category=marketing)):

- [HubSpot](/agentkit/connectors/hubspot/): Scalekit connector, OAuth, 457 tools
- [Mailchimp](/agentkit/connectors/mailchimp/): Scalekit connector, OAuth, 73 tools
- [Twitter / X](/agentkit/connectors/twitteroauth/): Scalekit connector, OAuth, 92 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
