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

# SalesRobot

SalesRobot automates LinkedIn outreach, campaign management, prospecting, messaging, and AI-personalized sales workflows.

- **Category:** ai sales tools
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 10
- **Triggers:** 0
- **Slug:** `SALESROBOT`
- **Version:** 20260826_00

## Tools

### Add Prospect to Campaign

**Slug:** `SALESROBOT_ADD_PROSPECT_TO_CAMPAIGN`

Add one identified LinkedIn prospect to a SalesRobot campaign.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | No | Prospect email address when lawfully available. |
| `job_title` | string | No | Prospect job title. |
| `last_name` | string | No | Prospect last name. |
| `first_name` | string | No | Prospect first name. |
| `profile_url` | string | No | Public LinkedIn profile URL; provide this or another stable LinkedIn identifier. |
| `company_name` | string | No | Prospect company name. |
| `campaign_uuid` | string | Yes | Destination campaign UUID from SALESROBOT_LIST_CAMPAIGNS. |
| `custom_fields` | object | No | Campaign custom field values keyed by field name. |
| `sales_nav_url` | string | No | LinkedIn Sales Navigator lead URL. |
| `unique_linkedin_id` | string | No | Stable LinkedIn member identifier when known. |
| `linkedin_account_uuid` | string | Yes | Connected LinkedIn account UUID that owns the campaign. |
| `starting_step_ordinal` | integer | No | Optional zero-based or provider-defined sequence step ordinal at which to start; use only when known. |

#### 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 LinkedIn Profile

**Slug:** `SALESROBOT_GET_LINKEDIN_PROFILE`

Retrieve a LinkedIn person or company profile through a connected SalesRobot LinkedIn account.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `identifier` | string | Yes | LinkedIn public identifier or provider-supported profile identifier, not a full URL unless SalesRobot accepts it. |
| `linkedin_account_uuid` | string | Yes | Connected LinkedIn account UUID used to access LinkedIn. |

#### 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 Prospect Sequence Status

**Slug:** `SALESROBOT_GET_PROSPECT_SEQUENCE_STATUS`

Get sequence-step execution and message status for one prospect, optionally within a campaign.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `campaign_uuid` | string | No | Campaign UUID when status should be restricted to one campaign. |
| `prospect_uuid` | string | Yes | Prospect UUID from SALESROBOT_LIST_CAMPAIGN_PROSPECTS. |
| `linkedin_account_uuid` | string | Yes | Connected LinkedIn account UUID. |

#### 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 Campaign Prospects

**Slug:** `SALESROBOT_LIST_CAMPAIGN_PROSPECTS`

List and filter prospects for a campaign or across campaigns on one connected LinkedIn account.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tags` | array | No | Return prospects with any of these tags. |
| `limit` | integer | No | Maximum prospects to return in this page (minimum 1). |
| `next_cursor` | string | No | Continuation cursor from a previous call; omit for the first page. |
| `search_term` | string | No | Search prospects by provider-supported text fields. |
| `no_reply_yet` | boolean | No | When true, return prospects with no reply. |
| `campaign_uuid` | string | No | Campaign UUID to restrict results; omit only when intentionally searching across campaigns. |
| `email_available` | boolean | No | Filter by whether an email address is available. |
| `last_activities` | array | No | Filter by CONNECTED, OPENED, REPLIED, REPLIED_AFTER_UNPAUSING, GROUP_MESSAGE_ACCEPTED, INMAIL_REJECTED, REPLIED_TO_EMAIL, or REPLIED_TO_EMAIL_AFTER_UNPAUSING. |
| `linkedin_account_uuid` | string | Yes | Connected LinkedIn account UUID. |

#### 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:** `SALESROBOT_LIST_CAMPAIGNS`

List and filter campaigns for one connected LinkedIn account, returning campaign UUIDs for prospect and status workflows.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum campaigns to return in this page (minimum 1). |
| `statuses` | array | No | Filter by CREATED, STARTED, PAUSED, COMPLETED, or MODIFYING. |
| `is_archived` | boolean | No | Filter archived or active campaign records. |
| `next_cursor` | string | No | Continuation cursor from a previous call; omit for the first page. |
| `search_term` | string | No | Filter campaigns by name or matching text. |
| `linkedin_account_uuid` | string | Yes | Connected LinkedIn account UUID from SALESROBOT_LIST_LINKEDIN_ACCOUNTS. |

#### 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 Inbox Threads

**Slug:** `SALESROBOT_LIST_INBOX_THREADS`

List and filter synchronized SalesRobot inbox threads for one connected LinkedIn account.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tags` | array | No | Return threads with any of these message tags. |
| `limit` | integer | No | Maximum threads to return in this page (minimum 1). |
| `is_paused` | boolean | No | Filter paused or active threads. |
| `is_unread` | boolean | No | Filter unread or read threads. |
| `thread_id` | string | No | Restrict results to one provider thread identifier. |
| `inbox_type` | string | No | Inbox type; defaults to linkedinInbox. |
| `next_cursor` | string | No | Continuation cursor from a previous call; omit for the first page. |
| `search_term` | string | No | Search synchronized threads. |
| `campaign_uuid` | string | No | Restrict threads to one campaign. |
| `prospect_uuids` | array | No | Restrict results to these prospect UUIDs. |
| `linkedin_account_uuid` | string | Yes | Connected LinkedIn account UUID. |

#### 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:** `SALESROBOT_LIST_LINKEDIN_ACCOUNTS`

List LinkedIn accounts connected to SalesRobot and return the account UUIDs required by most other tools.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tags` | array | No | Return accounts having any of these SalesRobot tags. |
| `limit` | integer | No | Maximum accounts to return in this page (minimum 1). |
| `next_cursor` | string | No | Continuation cursor from a previous response. Omit for the first page and pass it back unchanged to fetch the next page. |
| `search_term` | string | No | Filter accounts by name or other provider-supported account text. |
| `health_statuses` | array | No | Filter by HEALTHY, TEMPORARY_RESTRICTION, PERMANENT_RESTRICTION, PROXY_EXPIRED, or DISCONNECTED. |
| `license_statuses` | array | No | Filter by TRIAL_ACTIVE, TRIAL_EXPIRED, ACTIVE, CANCELLED, or PAUSED. |

#### 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 Posts

**Slug:** `SALESROBOT_LIST_LINKEDIN_POSTS`

List recent posts for a LinkedIn person or company through a connected SalesRobot LinkedIn account.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `identifier` | string | No | LinkedIn public identifier for the person or company. |
| `is_company` | boolean | No | Set true when the target is a company page. |
| `next_cursor` | string | No | Continuation cursor from a previous call; omit for the first page. |
| `profile_url` | string | No | LinkedIn profile or company URL when an identifier is unavailable. |
| `linkedin_account_uuid` | string | Yes | Connected LinkedIn account UUID used to access LinkedIn. |

#### 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 Message

**Slug:** `SALESROBOT_SEND_MESSAGE`

Send one message in an existing SalesRobot LinkedIn conversation. This immediately performs external outreach to the selected prospect; confirm the recipient and message content before calling.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `message` | string | Yes | Message text to send externally to the prospect. Confirm the content and recipient before calling. |
| `thread_id` | string | No | SalesRobot thread identifier from SALESROBOT_LIST_INBOX_THREADS. |
| `prospect_uuid` | string | No | Target prospect UUID when the conversation is addressed by prospect. |
| `attachment_url` | string | No | Publicly retrievable attachment URL; provide with attachment_file_name. |
| `unipile_chat_id` | string | No | Unipile chat identifier returned by SALESROBOT_LIST_INBOX_THREADS. |
| `attachment_file_name` | string | No | Attachment filename; provide with attachment_url. |
| `linkedin_account_uuid` | string | Yes | Connected LinkedIn account UUID that sends the external message. |
| `unipile_sales_nav_chat_id` | string | No | Sales Navigator chat identifier when addressing that conversation type. |

#### 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 |

### Update Prospect

**Slug:** `SALESROBOT_UPDATE_PROSPECT`

Update profile, contact, and custom field data for one existing SalesRobot prospect. Omitted fields remain unchanged.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | No | Updated email address. |
| `job_title` | string | No | Updated job title. |
| `last_name` | string | No | Updated last name. |
| `first_name` | string | No | Updated first name. |
| `profile_url` | string | No | Updated public LinkedIn profile URL. |
| `company_name` | string | No | Updated company name. |
| `phone_number` | string | No | Updated phone number. |
| `custom_fields` | object | No | Replacement or updated custom field values keyed by field name. |
| `prospect_uuid` | string | Yes | Prospect UUID from SALESROBOT_LIST_CAMPAIGN_PROSPECTS. |
| `sales_nav_url` | string | No | Updated Sales Navigator lead URL. |
| `linkedin_account_uuid` | string | Yes | Connected LinkedIn account UUID. |

#### 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 |