---
canonical_url: "https://docs.composio.dev/toolkits/botdog"
markdown_url: "https://docs.composio.dev/toolkits/botdog.md"
product: "platform"
version: null
last_updated: null
---

# Botdog

Botdog is a LinkedIn outreach platform for managing campaigns, leads, messaging, team analytics, and connected sending accounts.

- **Category:** sales & crm
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 12
- **Triggers:** 0
- **Slug:** `BOTDOG`
- **Version:** 00000000_00

## Tools

### Add Leads to Campaign

**Slug:** `BOTDOG_ADD_LEADS_TO_CAMPAIGN`

Create 1 to 100 lead records from LinkedIn profiles in an existing campaign. This changes the campaign's external audience and may cause its configured outreach workflow to act on those leads; it does not create or configure the campaign.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `leads` | array | Yes | LinkedIn profiles to create as leads in the campaign audience. Provide between 1 and 100 items. |
| `campaign_id` | string | Yes | Existing campaign ID, obtainable from BOTDOG_LIST_CAMPAIGNS. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Analytics

**Slug:** `BOTDOG_GET_ANALYTICS`

Return outreach analytics for a preset period, either as team/campaign totals or as a per-user breakdown.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `view` | string ("summary" | "by_user") | No | Use summary for aggregate invitation, message, and campaign metrics; use by_user for one metrics row per team user. |
| `period` | string ("last-7-days" | "last-30-days" | "last-90-days") | No | Preset reporting period. |
| `user_id` | string | No | Optional user ID to filter the summary view. Omit for team-wide totals; not accepted with view=by_user. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Campaign

**Slug:** `BOTDOG_GET_CAMPAIGN`

Return one campaign's identity, status, owner, and configured dates by campaign ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `campaign_id` | string | Yes | Campaign ID, obtainable from BOTDOG_LIST_CAMPAIGNS. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Campaign Sequence

**Slug:** `BOTDOG_GET_CAMPAIGN_SEQUENCE`

Return a campaign's configured workflow steps and branches in graph, tree, readable, or combined form; this does not edit or launch the campaign.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `format` | string ("graph" | "tree" | "readable" | "all") | No | Representation to return: graph is faithful and lossless; tree nests branches; readable is a text outline; all returns every representation. |
| `campaign_id` | string | Yes | Campaign ID, obtainable from BOTDOG_LIST_CAMPAIGNS. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Campaign Statistics

**Slug:** `BOTDOG_GET_CAMPAIGN_STATISTICS`

Return invitation, message, profile-visit, and response metrics and rates for one campaign.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `campaign_id` | string | Yes | Campaign ID, obtainable from BOTDOG_LIST_CAMPAIGNS. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Current Team

**Slug:** `BOTDOG_GET_CURRENT_TEAM`

Return the name and user count of the Botdog team authenticated by the connected API key.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Daily Analytics

**Slug:** `BOTDOG_GET_DAILY_ANALYTICS`

Return one outreach-activity row per calendar day plus totals for an explicit date range, optionally filtered by user or campaign.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_id` | string | No | Optional team user ID to filter the daily series. |
| `end_date` | string | Yes | Last date to include in YYYY-MM-DD format. |
| `start_date` | string | Yes | First date to include in YYYY-MM-DD format. |
| `campaign_id` | string | No | Optional campaign ID to filter the daily series. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List LinkedIn Accounts

**Slug:** `BOTDOG_LIST_ACCOUNTS`

Return connected LinkedIn sending accounts and their connection health for the authenticated Botdog team.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of connected LinkedIn accounts to return (1-200). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Campaigns

**Slug:** `BOTDOG_LIST_CAMPAIGNS`

Return campaigns in the authenticated Botdog team, optionally filtered by status or owner user IDs.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `status` | string ("ACTIVE" | "PAUSED" | "ARCHIVED" | "COMPLETED" | "CREATED") | No | Optional campaign status to return. |
| `owner_user_ids` | array | No | Optional Botdog user IDs whose campaigns to return. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Leads

**Slug:** `BOTDOG_LIST_LEADS`

Return one cursor-controlled page of team leads, optionally filtered by campaign, list, campaign state, reply state, unread state, or skip state.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum leads in this page (1-100). |
| `unread` | boolean | No | Set true for leads with an unread reply or false for leads without one. |
| `list_id` | string | No | Optional audience-list ID whose leads to return. |
| `replied` | boolean | No | Set true for leads that replied or false for leads that have not replied. |
| `skipped` | boolean | No | Set true for skipped leads or false for leads not skipped. |
| `campaign_id` | string | No | Optional campaign ID whose leads to return. |
| `next_cursor` | string | No | Opaque cursor returned by the previous call; omit for the first page. |
| `skip_reason` | string ("DUPLICATE_IN_ANOTHER_CAMPAIGN_AT_IMPORT" | "DUPLICATE_IN_ANOTHER_TEAM_CAMPAIGN_AT_IMPORT") | No | Optional provider skip reason for duplicate lead imports. |
| `campaign_status` | string ("CREATED" | "ACTIVE" | "PAUSED" | "ERROR" | "ARCHIVED" | "COMPLETED") | No | Optional status of the lead within its campaign. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Team Users

**Slug:** `BOTDOG_LIST_USERS`

Return Botdog users in the authenticated team so their IDs can be used in campaign and analytics filters.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum users to return. Botdog returns a complete bare array with no continuation token. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Send or Schedule Message

**Slug:** `BOTDOG_SEND_MESSAGE`

Immediately send a LinkedIn message to an existing lead conversation, or schedule delivery when send_at is provided. This causes irreversible external LinkedIn delivery and consumes the sending account's daily message budget. Botdog's changelog marks both documented routes as unreleased, and neither route has been live-verified by this integration. Never retry automatically after a timeout, network failure, server error, or other ambiguous result because Botdog may already have accepted the delivery.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `text` | string | Yes | Message text that will be delivered externally (1-8,000 characters). |
| `lead_id` | string | Yes | Existing Botdog lead ID with a LinkedIn conversation, obtainable from BOTDOG_LIST_LEADS. |
| `send_at` | string | No | Optional timezone-aware ISO 8601 delivery time from 60 seconds through 90 days in the future. Omit to send immediately. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |