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

# smartlead

> Smartlead - Cold email outreach platform. Manage campaigns, leads, email accounts, sequences, and analytics.

**Server path:** `/smartlead` | **Type:** Application | **PCID required:** Yes

## Tools

| Tool                                                                                            | Description                                |
| ----------------------------------------------------------------------------------------------- | ------------------------------------------ |
| [`smartlead_add_domain_block_list`](#smartlead_add_domain_block_list)                           | Add domains to block list                  |
| [`smartlead_add_email_account_to_campaign`](#smartlead_add_email_account_to_campaign)           | Add email account to a campaign            |
| [`smartlead_add_leads_to_campaign`](#smartlead_add_leads_to_campaign)                           | Add leads to a campaign                    |
| [`smartlead_configure_email_warmup`](#smartlead_configure_email_warmup)                         | Configure email warmup                     |
| [`smartlead_create_campaign`](#smartlead_create_campaign)                                       | Create a new campaign                      |
| [`smartlead_create_email_account`](#smartlead_create_email_account)                             | Create a new email account                 |
| [`smartlead_delete_campaign`](#smartlead_delete_campaign)                                       | Delete a campaign                          |
| [`smartlead_delete_email_account`](#smartlead_delete_email_account)                             | Delete an email account                    |
| [`smartlead_delete_lead_from_campaign`](#smartlead_delete_lead_from_campaign)                   | Delete a lead from a campaign              |
| [`smartlead_export_campaign_leads`](#smartlead_export_campaign_leads)                           | Export campaign leads to CSV               |
| [`smartlead_get_analytics_overview`](#smartlead_get_analytics_overview)                         | Get global analytics overview              |
| [`smartlead_get_campaign`](#smartlead_get_campaign)                                             | Get a campaign by ID                       |
| [`smartlead_get_campaign_analytics`](#smartlead_get_campaign_analytics)                         | Get top-level campaign analytics           |
| [`smartlead_get_campaign_analytics_by_date`](#smartlead_get_campaign_analytics_by_date)         | Get campaign analytics by date range       |
| [`smartlead_get_campaign_sequences`](#smartlead_get_campaign_sequences)                         | Get campaign email sequences               |
| [`smartlead_get_campaign_statistics`](#smartlead_get_campaign_statistics)                       | Get campaign statistics                    |
| [`smartlead_get_email_account`](#smartlead_get_email_account)                                   | Get an email account by ID                 |
| [`smartlead_get_email_warmup_stats`](#smartlead_get_email_warmup_stats)                         | Get email warmup statistics                |
| [`smartlead_get_lead_by_email`](#smartlead_get_lead_by_email)                                   | Get a lead by email address                |
| [`smartlead_get_lead_campaigns`](#smartlead_get_lead_campaigns)                                 | Get campaigns for a lead                   |
| [`smartlead_get_lead_categories`](#smartlead_get_lead_categories)                               | Get lead categories                        |
| [`smartlead_get_lead_message_history`](#smartlead_get_lead_message_history)                     | Get message history for a lead             |
| [`smartlead_list_campaign_email_accounts`](#smartlead_list_campaign_email_accounts)             | List email accounts assigned to a campaign |
| [`smartlead_list_campaign_leads`](#smartlead_list_campaign_leads)                               | List leads in a campaign                   |
| [`smartlead_list_campaigns`](#smartlead_list_campaigns)                                         | List all campaigns                         |
| [`smartlead_list_email_accounts`](#smartlead_list_email_accounts)                               | List all email accounts                    |
| [`smartlead_pause_lead`](#smartlead_pause_lead)                                                 | Pause a lead in a campaign                 |
| [`smartlead_remove_email_account_from_campaign`](#smartlead_remove_email_account_from_campaign) | Remove email account from a campaign       |
| [`smartlead_reply_to_email_thread`](#smartlead_reply_to_email_thread)                           | Reply to a lead's email thread             |
| [`smartlead_resume_lead`](#smartlead_resume_lead)                                               | Resume a lead in a campaign                |
| [`smartlead_save_campaign_sequences`](#smartlead_save_campaign_sequences)                       | Save campaign email sequences              |
| [`smartlead_unsubscribe_lead_from_campaign`](#smartlead_unsubscribe_lead_from_campaign)         | Unsubscribe a lead from a campaign         |
| [`smartlead_unsubscribe_lead_globally`](#smartlead_unsubscribe_lead_globally)                   | Unsubscribe a lead globally                |
| [`smartlead_update_campaign_schedule`](#smartlead_update_campaign_schedule)                     | Update campaign sending schedule           |
| [`smartlead_update_campaign_settings`](#smartlead_update_campaign_settings)                     | Update campaign general settings           |
| [`smartlead_update_campaign_status`](#smartlead_update_campaign_status)                         | Update campaign status                     |
| [`smartlead_update_email_account`](#smartlead_update_email_account)                             | Update an email account                    |
| [`smartlead_update_lead`](#smartlead_update_lead)                                               | Update a lead in a campaign                |

***

## smartlead\_add\_domain\_block\_list

Add domains to block list

**Parameters:**

| Parameter | Type      | Required | Default | Description              |
| --------- | --------- | -------- | ------- | ------------------------ |
| `domains` | string\[] | Yes      | —       | List of domains to block |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "domains": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "List of domains to block"
      }
    },
    "required": [
      "PCID",
      "domains"
    ]
  }
  ```
</Expandable>

***

## smartlead\_add\_email\_account\_to\_campaign

Add email account to a campaign

**Parameters:**

| Parameter           | Type       | Required | Default | Description                       |
| ------------------- | ---------- | -------- | ------- | --------------------------------- |
| `campaign_id`       | integer    | Yes      | —       | The campaign ID                   |
| `email_account_ids` | integer\[] | Yes      | —       | Array of email account IDs to add |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "campaign_id": {
        "type": "integer",
        "description": "The campaign ID"
      },
      "email_account_ids": {
        "type": "array",
        "items": {
          "type": "integer"
        },
        "description": "Array of email account IDs to add"
      }
    },
    "required": [
      "PCID",
      "campaign_id",
      "email_account_ids"
    ]
  }
  ```
</Expandable>

***

## smartlead\_add\_leads\_to\_campaign

Add leads to a campaign

**Parameters:**

| Parameter     | Type       | Required | Default | Description                      |
| ------------- | ---------- | -------- | ------- | -------------------------------- |
| `campaign_id` | integer    | Yes      | —       | The campaign ID                  |
| `import_type` | string     | No       | —       | Optional import type             |
| `lead_list`   | object\[]  | Yes      | —       | Array of lead objects to add     |
| `list_ids`    | integer\[] | No       | —       | Optional lead list IDs to import |
| `settings`    | object     | No       | —       | Import settings                  |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "campaign_id": {
        "type": "integer",
        "description": "The campaign ID"
      },
      "import_type": {
        "type": "string",
        "description": "Optional import type"
      },
      "lead_list": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "email": {
              "type": "string",
              "description": "Lead email address"
            },
            "first_name": {
              "type": "string",
              "description": "Lead first name"
            },
            "last_name": {
              "type": "string",
              "description": "Lead last name"
            },
            "company_name": {
              "type": "string",
              "description": "Lead company name"
            },
            "phone_number": {
              "type": "string",
              "description": "Lead phone number"
            },
            "website": {
              "type": "string",
              "description": "Lead website URL"
            },
            "location": {
              "type": "string",
              "description": "Lead location"
            },
            "linkedin_profile": {
              "type": "string",
              "description": "Lead LinkedIn profile URL"
            },
            "company_url": {
              "type": "string",
              "description": "Lead company website URL"
            },
            "custom_fields": {
              "type": "object",
              "description": "Additional custom fields as key-value pairs"
            }
          },
          "required": [
            "email"
          ]
        },
        "description": "Array of lead objects to add"
      },
      "list_ids": {
        "type": "array",
        "items": {
          "type": "integer"
        },
        "description": "Optional lead list IDs to import"
      },
      "settings": {
        "type": "object",
        "description": "Import settings",
        "properties": {
          "ignore_global_block_list": {
            "type": "boolean",
            "description": "Whether to ignore the global block list"
          },
          "ignore_unsubscribe_list": {
            "type": "boolean",
            "description": "Whether to ignore the unsubscribe list"
          },
          "ignore_duplicate_leads_in_other_campaign": {
            "type": "boolean",
            "description": "Whether to allow leads already present in other campaigns"
          },
          "ignore_community_bounce_list": {
            "type": "boolean",
            "description": "Whether to ignore the community bounce list"
          },
          "return_lead_ids": {
            "type": "boolean",
            "description": "Whether to return created lead IDs in the response"
          }
        }
      }
    },
    "required": [
      "PCID",
      "campaign_id",
      "lead_list"
    ]
  }
  ```
</Expandable>

***

## smartlead\_configure\_email\_warmup

Configure email warmup

**Parameters:**

| Parameter               | Type    | Required | Default | Description                             |
| ----------------------- | ------- | -------- | ------- | --------------------------------------- |
| `email_account_id`      | integer | Yes      | —       | The email account ID                    |
| `daily_rampup`          | integer | Yes      | —       | Additional warmup emails added per day  |
| `reply_rate_percentage` | integer | Yes      | —       | Percentage of warmup emails to reply to |
| `total_warmup_per_day`  | integer | Yes      | —       | Total warmup emails per day             |
| `warmup_enabled`        | boolean | Yes      | —       | Whether warmup is enabled               |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "email_account_id": {
        "type": "integer",
        "description": "The email account ID"
      },
      "daily_rampup": {
        "type": "integer",
        "description": "Additional warmup emails added per day"
      },
      "reply_rate_percentage": {
        "type": "integer",
        "description": "Percentage of warmup emails to reply to"
      },
      "total_warmup_per_day": {
        "type": "integer",
        "description": "Total warmup emails per day"
      },
      "warmup_enabled": {
        "type": "boolean",
        "description": "Whether warmup is enabled"
      }
    },
    "required": [
      "PCID",
      "email_account_id",
      "daily_rampup",
      "reply_rate_percentage",
      "total_warmup_per_day",
      "warmup_enabled"
    ]
  }
  ```
</Expandable>

***

## smartlead\_create\_campaign

Create a new campaign

**Parameters:**

| Parameter   | Type    | Required | Default | Description                                                     |
| ----------- | ------- | -------- | ------- | --------------------------------------------------------------- |
| `client_id` | integer | No       | —       | Client ID to associate the campaign with                        |
| `name`      | string  | No       | —       | Campaign name. Defaults to "Untitled Campaign" if not provided. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "client_id": {
        "type": "integer",
        "description": "Client ID to associate the campaign with"
      },
      "name": {
        "type": "string",
        "description": "Campaign name. Defaults to \"Untitled Campaign\" if not provided."
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## smartlead\_create\_email\_account

Create a new email account

**Parameters:**

| Parameter             | Type    | Required | Default | Description                                 |
| --------------------- | ------- | -------- | ------- | ------------------------------------------- |
| `bcc`                 | string  | No       | —       | BCC email address                           |
| `custom_tracking_url` | string  | No       | —       | Custom tracking domain URL                  |
| `from_email`          | string  | Yes      | —       | Email address to send from                  |
| `from_name`           | string  | Yes      | —       | Display name for the sender                 |
| `imap_host`           | string  | Yes      | —       | IMAP server hostname (e.g., imap.gmail.com) |
| `imap_port`           | integer | Yes      | —       | IMAP port (typically 993)                   |
| `max_email_per_day`   | integer | No       | —       | Maximum emails to send per day              |
| `password`            | string  | Yes      | —       | App password for SMTP/IMAP                  |
| `signature`           | string  | No       | —       | HTML email signature                        |
| `smtp_host`           | string  | Yes      | —       | SMTP server hostname (e.g., smtp.gmail.com) |
| `smtp_port`           | integer | Yes      | —       | SMTP port (587 for TLS, 465 for SSL)        |
| `smtp_port_type`      | string  | Yes      | —       | SMTP encryption type                        |
| `username`            | string  | Yes      | —       | SMTP/IMAP login username                    |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "bcc": {
        "type": "string",
        "description": "BCC email address"
      },
      "custom_tracking_url": {
        "type": "string",
        "description": "Custom tracking domain URL"
      },
      "from_email": {
        "type": "string",
        "description": "Email address to send from"
      },
      "from_name": {
        "type": "string",
        "description": "Display name for the sender"
      },
      "imap_host": {
        "type": "string",
        "description": "IMAP server hostname (e.g., imap.gmail.com)"
      },
      "imap_port": {
        "type": "integer",
        "description": "IMAP port (typically 993)"
      },
      "max_email_per_day": {
        "type": "integer",
        "description": "Maximum emails to send per day"
      },
      "password": {
        "type": "string",
        "description": "App password for SMTP/IMAP"
      },
      "signature": {
        "type": "string",
        "description": "HTML email signature"
      },
      "smtp_host": {
        "type": "string",
        "description": "SMTP server hostname (e.g., smtp.gmail.com)"
      },
      "smtp_port": {
        "type": "integer",
        "description": "SMTP port (587 for TLS, 465 for SSL)"
      },
      "smtp_port_type": {
        "type": "string",
        "description": "SMTP encryption type",
        "enum": [
          "TLS",
          "SSL"
        ]
      },
      "username": {
        "type": "string",
        "description": "SMTP/IMAP login username"
      }
    },
    "required": [
      "PCID",
      "from_email",
      "from_name",
      "imap_host",
      "imap_port",
      "password",
      "smtp_host",
      "smtp_port",
      "smtp_port_type",
      "username"
    ]
  }
  ```
</Expandable>

***

## smartlead\_delete\_campaign

Delete a campaign

**Parameters:**

| Parameter     | Type    | Required | Default | Description     |
| ------------- | ------- | -------- | ------- | --------------- |
| `campaign_id` | integer | Yes      | —       | The campaign ID |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "campaign_id": {
        "type": "integer",
        "description": "The campaign ID"
      }
    },
    "required": [
      "PCID",
      "campaign_id"
    ]
  }
  ```
</Expandable>

***

## smartlead\_delete\_email\_account

Delete an email account

**Parameters:**

| Parameter          | Type    | Required | Default | Description          |
| ------------------ | ------- | -------- | ------- | -------------------- |
| `email_account_id` | integer | Yes      | —       | The email account ID |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "email_account_id": {
        "type": "integer",
        "description": "The email account ID"
      }
    },
    "required": [
      "PCID",
      "email_account_id"
    ]
  }
  ```
</Expandable>

***

## smartlead\_delete\_lead\_from\_campaign

Delete a lead from a campaign

**Parameters:**

| Parameter     | Type    | Required | Default | Description     |
| ------------- | ------- | -------- | ------- | --------------- |
| `campaign_id` | integer | Yes      | —       | The campaign ID |
| `lead_id`     | integer | Yes      | —       | The lead ID     |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "campaign_id": {
        "type": "integer",
        "description": "The campaign ID"
      },
      "lead_id": {
        "type": "integer",
        "description": "The lead ID"
      }
    },
    "required": [
      "PCID",
      "campaign_id",
      "lead_id"
    ]
  }
  ```
</Expandable>

***

## smartlead\_export\_campaign\_leads

Export campaign leads to CSV

**Parameters:**

| Parameter     | Type    | Required | Default | Description     |
| ------------- | ------- | -------- | ------- | --------------- |
| `campaign_id` | integer | Yes      | —       | The campaign ID |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "campaign_id": {
        "type": "integer",
        "description": "The campaign ID"
      }
    },
    "required": [
      "PCID",
      "campaign_id"
    ]
  }
  ```
</Expandable>

***

## smartlead\_get\_analytics\_overview

Get global analytics overview

**Parameters:**

| Parameter      | Type    | Required | Default | Description                                           |
| -------------- | ------- | -------- | ------- | ----------------------------------------------------- |
| `start_date`   | string  | No       | —       | Start date in YYYY-MM-DD format                       |
| `end_date`     | string  | No       | —       | End date in YYYY-MM-DD format                         |
| `timezone`     | string  | No       | —       | IANA timezone string (for example, America/New\_York) |
| `client_ids`   | string  | No       | —       | Comma-separated client IDs                            |
| `campaign_ids` | string  | No       | —       | Comma-separated campaign IDs                          |
| `is_agency`    | boolean | No       | —       | Set true to filter for agency accounts                |
| `is_full`      | boolean | No       | —       | Set true to return full data set                      |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "start_date": {
        "type": "string",
        "description": "Start date in YYYY-MM-DD format"
      },
      "end_date": {
        "type": "string",
        "description": "End date in YYYY-MM-DD format"
      },
      "timezone": {
        "type": "string",
        "description": "IANA timezone string (for example, America/New_York)"
      },
      "client_ids": {
        "type": "string",
        "description": "Comma-separated client IDs"
      },
      "campaign_ids": {
        "type": "string",
        "description": "Comma-separated campaign IDs"
      },
      "is_agency": {
        "type": "boolean",
        "description": "Set true to filter for agency accounts"
      },
      "is_full": {
        "type": "boolean",
        "description": "Set true to return full data set"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## smartlead\_get\_campaign

Get a campaign by ID

**Parameters:**

| Parameter     | Type    | Required | Default | Description     |
| ------------- | ------- | -------- | ------- | --------------- |
| `campaign_id` | integer | Yes      | —       | The campaign ID |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "campaign_id": {
        "type": "integer",
        "description": "The campaign ID"
      }
    },
    "required": [
      "PCID",
      "campaign_id"
    ]
  }
  ```
</Expandable>

***

## smartlead\_get\_campaign\_analytics

Get top-level campaign analytics

**Parameters:**

| Parameter     | Type    | Required | Default | Description     |
| ------------- | ------- | -------- | ------- | --------------- |
| `campaign_id` | integer | Yes      | —       | The campaign ID |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "campaign_id": {
        "type": "integer",
        "description": "The campaign ID"
      }
    },
    "required": [
      "PCID",
      "campaign_id"
    ]
  }
  ```
</Expandable>

***

## smartlead\_get\_campaign\_analytics\_by\_date

Get campaign analytics by date range

**Parameters:**

| Parameter     | Type    | Required | Default | Description                    |
| ------------- | ------- | -------- | ------- | ------------------------------ |
| `campaign_id` | integer | Yes      | —       | The campaign ID                |
| `start_date`  | string  | No       | —       | Start date (YYYY-MM-DD format) |
| `end_date`    | string  | No       | —       | End date (YYYY-MM-DD format)   |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "campaign_id": {
        "type": "integer",
        "description": "The campaign ID"
      },
      "start_date": {
        "type": "string",
        "description": "Start date (YYYY-MM-DD format)"
      },
      "end_date": {
        "type": "string",
        "description": "End date (YYYY-MM-DD format)"
      }
    },
    "required": [
      "PCID",
      "campaign_id"
    ]
  }
  ```
</Expandable>

***

## smartlead\_get\_campaign\_sequences

Get campaign email sequences

**Parameters:**

| Parameter     | Type    | Required | Default | Description     |
| ------------- | ------- | -------- | ------- | --------------- |
| `campaign_id` | integer | Yes      | —       | The campaign ID |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "campaign_id": {
        "type": "integer",
        "description": "The campaign ID"
      }
    },
    "required": [
      "PCID",
      "campaign_id"
    ]
  }
  ```
</Expandable>

***

## smartlead\_get\_campaign\_statistics

Get campaign statistics

**Parameters:**

| Parameter     | Type    | Required | Default | Description     |
| ------------- | ------- | -------- | ------- | --------------- |
| `campaign_id` | integer | Yes      | —       | The campaign ID |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "campaign_id": {
        "type": "integer",
        "description": "The campaign ID"
      }
    },
    "required": [
      "PCID",
      "campaign_id"
    ]
  }
  ```
</Expandable>

***

## smartlead\_get\_email\_account

Get an email account by ID

**Parameters:**

| Parameter          | Type    | Required | Default | Description          |
| ------------------ | ------- | -------- | ------- | -------------------- |
| `email_account_id` | integer | Yes      | —       | The email account ID |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "email_account_id": {
        "type": "integer",
        "description": "The email account ID"
      }
    },
    "required": [
      "PCID",
      "email_account_id"
    ]
  }
  ```
</Expandable>

***

## smartlead\_get\_email\_warmup\_stats

Get email warmup statistics

**Parameters:**

| Parameter          | Type    | Required | Default | Description          |
| ------------------ | ------- | -------- | ------- | -------------------- |
| `email_account_id` | integer | Yes      | —       | The email account ID |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "email_account_id": {
        "type": "integer",
        "description": "The email account ID"
      }
    },
    "required": [
      "PCID",
      "email_account_id"
    ]
  }
  ```
</Expandable>

***

## smartlead\_get\_lead\_by\_email

Get a lead by email address

**Parameters:**

| Parameter | Type   | Required | Default | Description              |
| --------- | ------ | -------- | ------- | ------------------------ |
| `email`   | string | Yes      | —       | The lead's email address |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "email": {
        "type": "string",
        "description": "The lead's email address"
      }
    },
    "required": [
      "PCID",
      "email"
    ]
  }
  ```
</Expandable>

***

## smartlead\_get\_lead\_campaigns

Get campaigns for a lead

**Parameters:**

| Parameter | Type    | Required | Default | Description |
| --------- | ------- | -------- | ------- | ----------- |
| `lead_id` | integer | Yes      | —       | The lead ID |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "lead_id": {
        "type": "integer",
        "description": "The lead ID"
      }
    },
    "required": [
      "PCID",
      "lead_id"
    ]
  }
  ```
</Expandable>

***

## smartlead\_get\_lead\_categories

Get lead categories

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## smartlead\_get\_lead\_message\_history

Get message history for a lead

**Parameters:**

| Parameter     | Type    | Required | Default | Description     |
| ------------- | ------- | -------- | ------- | --------------- |
| `campaign_id` | integer | Yes      | —       | The campaign ID |
| `lead_id`     | integer | Yes      | —       | The lead ID     |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "campaign_id": {
        "type": "integer",
        "description": "The campaign ID"
      },
      "lead_id": {
        "type": "integer",
        "description": "The lead ID"
      }
    },
    "required": [
      "PCID",
      "campaign_id",
      "lead_id"
    ]
  }
  ```
</Expandable>

***

## smartlead\_list\_campaign\_email\_accounts

List email accounts assigned to a campaign

**Parameters:**

| Parameter     | Type    | Required | Default | Description     |
| ------------- | ------- | -------- | ------- | --------------- |
| `campaign_id` | integer | Yes      | —       | The campaign ID |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "campaign_id": {
        "type": "integer",
        "description": "The campaign ID"
      }
    },
    "required": [
      "PCID",
      "campaign_id"
    ]
  }
  ```
</Expandable>

***

## smartlead\_list\_campaign\_leads

List leads in a campaign

**Parameters:**

| Parameter     | Type    | Required | Default | Description                           |
| ------------- | ------- | -------- | ------- | ------------------------------------- |
| `campaign_id` | integer | Yes      | —       | The campaign ID                       |
| `offset`      | integer | No       | —       | Pagination offset                     |
| `limit`       | integer | No       | —       | Number of results to return (max 100) |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "campaign_id": {
        "type": "integer",
        "description": "The campaign ID"
      },
      "offset": {
        "type": "integer",
        "description": "Pagination offset"
      },
      "limit": {
        "type": "integer",
        "description": "Number of results to return (max 100)"
      }
    },
    "required": [
      "PCID",
      "campaign_id"
    ]
  }
  ```
</Expandable>

***

## smartlead\_list\_campaigns

List all campaigns

**Parameters:**

| Parameter      | Type    | Required | Default | Description                           |
| -------------- | ------- | -------- | ------- | ------------------------------------- |
| `client_id`    | integer | No       | —       | Filter campaigns by client ID         |
| `include_tags` | boolean | No       | —       | Include campaign tags in the response |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "client_id": {
        "type": "integer",
        "description": "Filter campaigns by client ID"
      },
      "include_tags": {
        "type": "boolean",
        "description": "Include campaign tags in the response"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## smartlead\_list\_email\_accounts

List all email accounts

**Parameters:**

| Parameter | Type    | Required | Default | Description                           |
| --------- | ------- | -------- | ------- | ------------------------------------- |
| `offset`  | integer | No       | —       | Pagination offset                     |
| `limit`   | integer | No       | —       | Number of results to return (max 100) |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "offset": {
        "type": "integer",
        "description": "Pagination offset"
      },
      "limit": {
        "type": "integer",
        "description": "Number of results to return (max 100)"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## smartlead\_pause\_lead

Pause a lead in a campaign

**Parameters:**

| Parameter     | Type    | Required | Default | Description     |
| ------------- | ------- | -------- | ------- | --------------- |
| `campaign_id` | integer | Yes      | —       | The campaign ID |
| `lead_id`     | integer | Yes      | —       | The lead ID     |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "campaign_id": {
        "type": "integer",
        "description": "The campaign ID"
      },
      "lead_id": {
        "type": "integer",
        "description": "The lead ID"
      }
    },
    "required": [
      "PCID",
      "campaign_id",
      "lead_id"
    ]
  }
  ```
</Expandable>

***

## smartlead\_remove\_email\_account\_from\_campaign

Remove email account from a campaign

**Parameters:**

| Parameter           | Type       | Required | Default | Description                          |
| ------------------- | ---------- | -------- | ------- | ------------------------------------ |
| `campaign_id`       | integer    | Yes      | —       | The campaign ID                      |
| `email_account_ids` | integer\[] | Yes      | —       | Array of email account IDs to remove |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "campaign_id": {
        "type": "integer",
        "description": "The campaign ID"
      },
      "email_account_ids": {
        "type": "array",
        "items": {
          "type": "integer"
        },
        "description": "Array of email account IDs to remove"
      }
    },
    "required": [
      "PCID",
      "campaign_id",
      "email_account_ids"
    ]
  }
  ```
</Expandable>

***

## smartlead\_reply\_to\_email\_thread

Reply to a lead's email thread

**Parameters:**

| Parameter     | Type    | Required | Default | Description                  |
| ------------- | ------- | -------- | ------- | ---------------------------- |
| `campaign_id` | integer | Yes      | —       | The campaign ID              |
| `email_body`  | string  | Yes      | —       | The reply email body in HTML |
| `lead_id`     | integer | Yes      | —       | The lead ID to reply to      |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "campaign_id": {
        "type": "integer",
        "description": "The campaign ID"
      },
      "email_body": {
        "type": "string",
        "description": "The reply email body in HTML"
      },
      "lead_id": {
        "type": "integer",
        "description": "The lead ID to reply to"
      }
    },
    "required": [
      "PCID",
      "campaign_id",
      "email_body",
      "lead_id"
    ]
  }
  ```
</Expandable>

***

## smartlead\_resume\_lead

Resume a lead in a campaign

**Parameters:**

| Parameter     | Type    | Required | Default | Description     |
| ------------- | ------- | -------- | ------- | --------------- |
| `campaign_id` | integer | Yes      | —       | The campaign ID |
| `lead_id`     | integer | Yes      | —       | The lead ID     |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "campaign_id": {
        "type": "integer",
        "description": "The campaign ID"
      },
      "lead_id": {
        "type": "integer",
        "description": "The lead ID"
      }
    },
    "required": [
      "PCID",
      "campaign_id",
      "lead_id"
    ]
  }
  ```
</Expandable>

***

## smartlead\_save\_campaign\_sequences

Save campaign email sequences

**Parameters:**

| Parameter     | Type      | Required | Default | Description     |
| ------------- | --------- | -------- | ------- | --------------- |
| `campaign_id` | integer   | Yes      | —       | The campaign ID |
| `body`        | object\[] | Yes      | —       | Request body    |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "campaign_id": {
        "type": "integer",
        "description": "The campaign ID"
      },
      "body": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "seq_number": {
              "type": "integer",
              "description": "Sequence step number"
            },
            "seq_delay_details": {
              "type": "object",
              "description": "Seq Delay Details"
            },
            "variant_distribution_type": {
              "type": "string",
              "description": "How to distribute variants (e.g., MANUALLY_EQUAL)"
            },
            "variants": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "subject": {
                    "type": "string",
                    "description": "Email subject line. Supports merge tags like {{first_name}}"
                  },
                  "email_body": {
                    "type": "string",
                    "description": "Email body in HTML. Supports merge tags like {{first_name}}"
                  },
                  "variant_label": {
                    "type": "string",
                    "description": "Variant label (e.g., A, B)"
                  }
                }
              },
              "description": "The variants value"
            }
          },
          "required": [
            "seq_number",
            "seq_delay_details",
            "variant_distribution_type",
            "variants"
          ]
        },
        "description": "Request body"
      }
    },
    "required": [
      "PCID",
      "campaign_id",
      "body"
    ]
  }
  ```
</Expandable>

***

## smartlead\_unsubscribe\_lead\_from\_campaign

Unsubscribe a lead from a campaign

**Parameters:**

| Parameter     | Type    | Required | Default | Description     |
| ------------- | ------- | -------- | ------- | --------------- |
| `campaign_id` | integer | Yes      | —       | The campaign ID |
| `lead_id`     | integer | Yes      | —       | The lead ID     |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "campaign_id": {
        "type": "integer",
        "description": "The campaign ID"
      },
      "lead_id": {
        "type": "integer",
        "description": "The lead ID"
      }
    },
    "required": [
      "PCID",
      "campaign_id",
      "lead_id"
    ]
  }
  ```
</Expandable>

***

## smartlead\_unsubscribe\_lead\_globally

Unsubscribe a lead globally

**Parameters:**

| Parameter | Type    | Required | Default | Description |
| --------- | ------- | -------- | ------- | ----------- |
| `lead_id` | integer | Yes      | —       | The lead ID |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "lead_id": {
        "type": "integer",
        "description": "The lead ID"
      }
    },
    "required": [
      "PCID",
      "lead_id"
    ]
  }
  ```
</Expandable>

***

## smartlead\_update\_campaign\_schedule

Update campaign sending schedule

**Parameters:**

| Parameter             | Type       | Required | Default | Description                                    |
| --------------------- | ---------- | -------- | ------- | ---------------------------------------------- |
| `campaign_id`         | integer    | Yes      | —       | The campaign ID                                |
| `days_of_the_week`    | integer\[] | Yes      | —       | Active days (0=Sunday through 6=Saturday)      |
| `end_hour`            | string     | Yes      | —       | End hour in 24-hour format (e.g., 19:00)       |
| `max_leads_per_day`   | integer    | Yes      | —       | Maximum number of leads to contact per day     |
| `min_time_btw_emails` | integer    | Yes      | —       | Minimum minutes between emails                 |
| `start_hour`          | string     | Yes      | —       | Start hour in 24-hour format (e.g., 09:00)     |
| `timezone`            | string     | Yes      | —       | IANA timezone format (e.g., America/New\_York) |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "campaign_id": {
        "type": "integer",
        "description": "The campaign ID"
      },
      "days_of_the_week": {
        "type": "array",
        "items": {
          "type": "integer"
        },
        "description": "Active days (0=Sunday through 6=Saturday)"
      },
      "end_hour": {
        "type": "string",
        "description": "End hour in 24-hour format (e.g., 19:00)"
      },
      "max_leads_per_day": {
        "type": "integer",
        "description": "Maximum number of leads to contact per day"
      },
      "min_time_btw_emails": {
        "type": "integer",
        "description": "Minimum minutes between emails"
      },
      "start_hour": {
        "type": "string",
        "description": "Start hour in 24-hour format (e.g., 09:00)"
      },
      "timezone": {
        "type": "string",
        "description": "IANA timezone format (e.g., America/New_York)"
      }
    },
    "required": [
      "PCID",
      "campaign_id",
      "days_of_the_week",
      "end_hour",
      "max_leads_per_day",
      "min_time_btw_emails",
      "start_hour",
      "timezone"
    ]
  }
  ```
</Expandable>

***

## smartlead\_update\_campaign\_settings

Update campaign general settings

**Parameters:**

| Parameter                | Type      | Required | Default | Description                               |
| ------------------------ | --------- | -------- | ------- | ----------------------------------------- |
| `campaign_id`            | integer   | Yes      | —       | The campaign ID                           |
| `client_id`              | integer   | No       | —       | Client ID to associate (null to remove)   |
| `enable_ai_esp_matching` | boolean   | No       | —       | Enable AI ESP matching                    |
| `follow_up_percentage`   | number    | No       | —       | Follow-up percentage (0-100)              |
| `send_as_plain_text`     | boolean   | No       | —       | Send emails as plain text instead of HTML |
| `stop_lead_settings`     | string    | No       | —       | When to stop sending to a lead            |
| `track_settings`         | string\[] | No       | —       | Tracking flags to disable                 |
| `unsubscribe_text`       | string    | No       | —       | Custom unsubscribe text                   |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "campaign_id": {
        "type": "integer",
        "description": "The campaign ID"
      },
      "client_id": {
        "type": "integer",
        "description": "Client ID to associate (null to remove)"
      },
      "enable_ai_esp_matching": {
        "type": "boolean",
        "description": "Enable AI ESP matching"
      },
      "follow_up_percentage": {
        "type": "number",
        "description": "Follow-up percentage (0-100)"
      },
      "send_as_plain_text": {
        "type": "boolean",
        "description": "Send emails as plain text instead of HTML"
      },
      "stop_lead_settings": {
        "type": "string",
        "description": "When to stop sending to a lead",
        "enum": [
          "REPLY_TO_AN_EMAIL",
          "OPENED_EMAIL",
          "CLICKED_LINK",
          "NEVER"
        ]
      },
      "track_settings": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "DONT_EMAIL_OPEN",
            "DONT_LINK_CLICK"
          ]
        },
        "description": "Tracking flags to disable"
      },
      "unsubscribe_text": {
        "type": "string",
        "description": "Custom unsubscribe text"
      }
    },
    "required": [
      "PCID",
      "campaign_id"
    ]
  }
  ```
</Expandable>

***

## smartlead\_update\_campaign\_status

Update campaign status

**Parameters:**

| Parameter     | Type    | Required | Default | Description                                    |
| ------------- | ------- | -------- | ------- | ---------------------------------------------- |
| `campaign_id` | integer | Yes      | —       | The campaign ID                                |
| `status`      | string  | Yes      | —       | New campaign status: START, PAUSED, or STOPPED |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "campaign_id": {
        "type": "integer",
        "description": "The campaign ID"
      },
      "status": {
        "type": "string",
        "description": "New campaign status: START, PAUSED, or STOPPED",
        "enum": [
          "START",
          "PAUSED",
          "STOPPED"
        ]
      }
    },
    "required": [
      "PCID",
      "campaign_id",
      "status"
    ]
  }
  ```
</Expandable>

***

## smartlead\_update\_email\_account

Update an email account

**Parameters:**

| Parameter             | Type    | Required | Default | Description                    |
| --------------------- | ------- | -------- | ------- | ------------------------------ |
| `email_account_id`    | integer | Yes      | —       | The email account ID           |
| `bcc`                 | string  | No       | —       | BCC email address              |
| `custom_tracking_url` | string  | No       | —       | Custom tracking domain URL     |
| `from_email`          | string  | No       | —       | Email address to send from     |
| `from_name`           | string  | No       | —       | Display name for the sender    |
| `max_email_per_day`   | integer | No       | —       | Maximum emails to send per day |
| `signature`           | string  | No       | —       | HTML email signature           |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "email_account_id": {
        "type": "integer",
        "description": "The email account ID"
      },
      "bcc": {
        "type": "string",
        "description": "BCC email address"
      },
      "custom_tracking_url": {
        "type": "string",
        "description": "Custom tracking domain URL"
      },
      "from_email": {
        "type": "string",
        "description": "Email address to send from"
      },
      "from_name": {
        "type": "string",
        "description": "Display name for the sender"
      },
      "max_email_per_day": {
        "type": "integer",
        "description": "Maximum emails to send per day"
      },
      "signature": {
        "type": "string",
        "description": "HTML email signature"
      }
    },
    "required": [
      "PCID",
      "email_account_id"
    ]
  }
  ```
</Expandable>

***

## smartlead\_update\_lead

Update a lead in a campaign

**Parameters:**

| Parameter          | Type    | Required | Default | Description                                 |
| ------------------ | ------- | -------- | ------- | ------------------------------------------- |
| `campaign_id`      | integer | Yes      | —       | The campaign ID                             |
| `lead_id`          | integer | Yes      | —       | The lead ID                                 |
| `company_name`     | string  | No       | —       | Lead company name                           |
| `company_url`      | string  | No       | —       | Lead company website URL                    |
| `custom_fields`    | object  | No       | —       | Additional custom fields as key-value pairs |
| `email`            | string  | No       | —       | Lead email address                          |
| `first_name`       | string  | No       | —       | Lead first name                             |
| `last_name`        | string  | No       | —       | Lead last name                              |
| `linkedin_profile` | string  | No       | —       | Lead LinkedIn profile URL                   |
| `location`         | string  | No       | —       | Lead location                               |
| `phone_number`     | string  | No       | —       | Lead phone number                           |
| `website`          | string  | No       | —       | Lead website URL                            |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "campaign_id": {
        "type": "integer",
        "description": "The campaign ID"
      },
      "lead_id": {
        "type": "integer",
        "description": "The lead ID"
      },
      "company_name": {
        "type": "string",
        "description": "Lead company name"
      },
      "company_url": {
        "type": "string",
        "description": "Lead company website URL"
      },
      "custom_fields": {
        "type": "object",
        "description": "Additional custom fields as key-value pairs"
      },
      "email": {
        "type": "string",
        "description": "Lead email address"
      },
      "first_name": {
        "type": "string",
        "description": "Lead first name"
      },
      "last_name": {
        "type": "string",
        "description": "Lead last name"
      },
      "linkedin_profile": {
        "type": "string",
        "description": "Lead LinkedIn profile URL"
      },
      "location": {
        "type": "string",
        "description": "Lead location"
      },
      "phone_number": {
        "type": "string",
        "description": "Lead phone number"
      },
      "website": {
        "type": "string",
        "description": "Lead website URL"
      }
    },
    "required": [
      "PCID",
      "campaign_id",
      "lead_id"
    ]
  }
  ```
</Expandable>