Integrations
Connect and manage workspace integrations — Apollo and Instantly — and trigger Apollo list imports.
Tools (7)
Section titled “Tools (7)”list_integrations
Section titled “list_integrations”Full name: campaignstack_list_integrations
List connected integrations for a workspace (Apollo, Instantly, Clay). Returns provider, connection status, and last-tested timestamp. API keys and webhook secrets are never returned — only a boolean indicating they are set. Use campaignstack_connect_apollo or campaignstack_connect_instantly to add integrations.
Parameters
Section titled “Parameters”| Name | Type | Required | Default | Description |
|---|---|---|---|---|
workspaceId | string | No | — | Workspace ID (defaults to the bound workspace) |
list_apollo_sources
Section titled “list_apollo_sources”Full name: campaignstack_list_apollo_sources
List Apollo lists (labels) available in the connected Apollo account. Returns each list’s id, name, and estimated contact count. Use the returned id values with campaignstack_import_apollo_list to import contacts. Requires a connected Apollo integration — use campaignstack_connect_apollo first if needed.
Parameters
Section titled “Parameters”| Name | Type | Required | Default | Description |
|---|---|---|---|---|
workspaceId | string | No | — | Workspace ID (defaults to the bound workspace) |
get_apollo_import_progress
Section titled “get_apollo_import_progress”Full name: campaignstack_get_apollo_import_progress
Get the progress of an in-flight or recently completed Apollo list import. Returns processedCount, importedCount, totalCount, status (in_progress / completed / failed), and any error message. Poll this after campaignstack_import_apollo_list to track large imports. Use the same listId you passed to import_apollo_list.
Parameters
Section titled “Parameters”| Name | Type | Required | Default | Description |
|---|---|---|---|---|
listId | string | Yes | — | (min length: 1) |
workspaceId | string | No | — | Workspace ID (defaults to the bound workspace) |
connect_apollo
Section titled “connect_apollo”Full name: campaignstack_connect_apollo
Connect an Apollo.io account by providing an API key. Validates the key against the Apollo API and stores the integration. Returns success: true when the key is valid and the integration is connected. Returns success: false (with integrationId still created) when the key fails validation. Use campaignstack_list_apollo_sources after connecting to browse available contact lists.
Parameters
Section titled “Parameters”| Name | Type | Required | Default | Description |
|---|---|---|---|---|
apiKey | string | Yes | — | (min length: 10) |
workspaceId | string | No | — | Workspace ID (defaults to the bound workspace) |
connect_instantly
Section titled “connect_instantly”Full name: campaignstack_connect_instantly
Connect an Instantly.ai account by providing an API key. Validates the key against the Instantly API and stores the integration. Returns success: true when the key is valid and the integration is connected. Returns success: false (with integrationId still created) when the key fails validation.
Parameters
Section titled “Parameters”| Name | Type | Required | Default | Description |
|---|---|---|---|---|
apiKey | string | Yes | — | (min length: 10) |
workspaceId | string | No | — | Workspace ID (defaults to the bound workspace) |
disconnect_integration
Section titled “disconnect_integration”Full name: campaignstack_disconnect_integration
Disconnect (remove) an integration by provider. Permanently deletes the integration record and its stored credentials. Valid providers: apollo, instantly, clay. Use campaignstack_list_integrations to see which integrations are connected.
Parameters
Section titled “Parameters”| Name | Type | Required | Default | Description |
|---|---|---|---|---|
provider | apollo | instantly | clay | Yes | — | Integration provider to disconnect |
workspaceId | string | No | — | Workspace ID (defaults to the bound workspace) |
import_apollo_list
Section titled “import_apollo_list”Full name: campaignstack_import_apollo_list
Import leads from an Apollo contact list into CampaignStack. Fetches contacts from the specified Apollo list (up to 50,000 records across 500 pages) and creates or merges leads. Deduplicates by email and LinkedIn URL. Optionally filter by campaign ICP with onlyMatchingIcp: true. For large lists this runs asynchronously — use campaignstack_get_apollo_import_progress to check status. Use campaignstack_list_apollo_sources to find valid listId values.
Parameters
Section titled “Parameters”| Name | Type | Required | Default | Description |
|---|---|---|---|---|
listId | string | Yes | — | (min length: 1) |
listName | string | No | — | Display name for the Apollo list (for progress tracking) |
listCount | integer | No | — | Expected total contact count (for progress display) (min: 0) |
campaignId | string | No | — | Campaign ID to filter by ICP (requires onlyMatchingIcp: true) |
onlyMatchingIcp | boolean | No | — | Import only contacts matching the campaign ICP |
workspaceId | string | No | — | Workspace ID (defaults to the bound workspace) |