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

# ManyReach

ManyReach is a cold email outreach platform for managing campaigns, prospects, senders, messages, and workspaces.

- **Category:** email
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 16
- **Triggers:** 0
- **Slug:** `MANYREACH`
- **Version:** 00000000_00

## Tools

### Create Campaign

**Slug:** `MANYREACH_CREATE_CAMPAIGN`

Create and save a new draft campaign's configuration. This tool is draft-only: it does not start, pause, archive, or otherwise activate outreach, and it never sends email.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Campaign name. |
| `subject` | string | No | Subject line for the initial campaign email. |
| `body_html` | string | No | HTML body for the initial campaign email. |
| `folder_id` | integer | No | Positive folder ID used to organize the campaign. |
| `from_name` | string | No | Display name shown in the From field. |
| `daily_limit` | integer | No | Maximum sends per day, from 1 through 10000. |
| `description` | string | No | Campaign purpose or goal. |
| `track_opens` | boolean | No | Enable email-open tracking. |
| `track_clicks` | boolean | No | Enable link-click tracking. |
| `sender_emails` | array | No | Sender email addresses already configured in ManyReach. |
| `reply_to_email` | string | No | Reply-to email address for prospect responses. |
| `daily_limit_per` | string ("Sender" | "Campaign") | No | Apply the daily limit per sender or across the whole campaign. |
| `schedule_sending` | boolean | No | Constrain campaign sending to its configured schedule. |
| `text_only_emails` | boolean | No | Use plain-text email rather than HTML. |
| `delay_min_minutes` | integer | No | Minimum delay between consecutive sends, from 1 through 1440 minutes. |
| `schedule_time_zone` | string | No | IANA time zone for the campaign schedule, such as America/New_York. |
| `use_prospects_time_zone` | boolean | No | Prefer each prospect's known time zone when scheduling. |

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

### Create Mailing List

**Slug:** `MANYREACH_CREATE_LIST`

Create a ManyReach mailing list.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `title` | string | Yes | Mailing-list title. |
| `folder_id` | integer | No | Positive folder ID used to organize the mailing list. |

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

### Create Prospect

**Slug:** `MANYREACH_CREATE_PROSPECT`

Create one ManyReach prospect. sending_active controls whether the prospect is eligible for campaign sending and safely defaults to false. This tool only saves the prospect; it does not start a campaign or send email.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `city` | string | No | City. |
| `email` | string | Yes | Valid email address for the new prospect. |
| `notes` | string | No | Internal notes about the prospect. |
| `phone` | string | No | Contact phone number. |
| `state` | string | No | State or province. |
| `domain` | string | No | Company domain. |
| `company` | string | No | Company name. |
| `country` | string | No | Country. |
| `website` | string | No | Company website URL. |
| `industry` | string | No | Company industry. |
| `location` | string | No | Geographic location or address. |
| `last_name` | string | No | Last name used for personalization. |
| `first_name` | string | No | First name used for personalization. |
| `icebreaker` | string | No | Personalized icebreaker. |
| `base_list_id` | integer | No | Positive mailing-list ID to assign as the prospect's base list. |
| `company_size` | string | No | Company size or employee range. |
| `job_position` | string | No | Job title or position. |
| `custom_fields` | object | No | Personalization values keyed only by custom1 through custom20; each value may contain up to 2000 characters. |
| `company_social` | string | No | Company social-profile URL. |
| `sending_active` | boolean | No | Whether the prospect is eligible for campaign sending. Defaults to false for safety and is always sent explicitly. |
| `sending_status` | string ("Unknown" | "EspMatchNotFound" | "EspNotAllowed" | "NoWarmup" | "NotReceiving" | "WarmupLimits" | "SendingLimits" | "NoSender" | "Stuck" | "MailboxInexistent" | "EmptySubject" | "EmptyBody" | "MissingPlaceholder" | "Invalid" | "Blacklisted" | "Stopped" | "Unsub" | "BounceHard" | "BounceSoft" | "AutoNolonger" | "AutoOoo" | "AutoReply" | "CollegueReplied" | "SenderDisconnected" | "Paused" | "InsufficientCredit" | "ScheduleInactive" | "NotInterested" | "NotSet" | "Neutral" | "MaybeLater" | "Interested" | "MeetingBooked" | "MeetingCompleted" | "Won" | "Subbed") | No | Exact ManyReach campaign-participation status. |
| `personal_social` | string | No | Personal social-profile URL. |

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

### Create Tag

**Slug:** `MANYREACH_CREATE_TAG`

Create a CRM, campaign, or sender tag.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `title` | string | Yes | Tag title. |
| `tag_type` | string ("Crm" | "Campaign" | "Sender") | No | Resource class for a new tag. ManyReach defaults to Crm when omitted. |
| `description` | string | No | Tag purpose or criteria. |

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

### Delete Outreach Resource

**Slug:** `MANYREACH_DELETE_OUTREACH_RESOURCE`

Permanently and irreversibly delete exactly one campaign, prospect, mailing list, or tag by ID. This cannot be undone. The tool rejects the request unless confirm_deletion=true after explicit caller confirmation. Forced tag deletion also permanently removes all tag assignments and must be explicitly requested.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `resource_id` | integer | Yes | Positive ID of the exact outreach resource to permanently delete. |
| `resource_type` | string ("campaign" | "prospect" | "list" | "tag") | Yes | Kind of outreach resource to permanently and irreversibly delete. |
| `confirm_deletion` | boolean | Yes | Required safety confirmation. Set to true only after the caller explicitly confirms permanent, irreversible deletion of this exact resource. |
| `force_tag_delete` | boolean | No | Tags only: also permanently remove every assignment of the tag before deleting it. Defaults to false; use true only with explicit caller approval. |

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

**Slug:** `MANYREACH_GET_ACCOUNT_OVERVIEW`

Return the authenticated ManyReach organization together with its sending-credit and data-token balances.

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

Find campaigns in the authenticated organization, optionally filtering by lifecycle status or archived state. Returns one page at a time.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum campaigns to return in this page (1-1000). |
| `cursor` | string | No | Opaque continuation cursor returned by a previous call; omit for the first page. |
| `status` | string ("Draft" | "Running" | "Paused" | "Completed" | "Archived" | "Warning" | "Blocked" | "Scheduled" | "Preparing") | No | Exact campaign lifecycle status from the ManyReach campaign schema. |
| `include_archived` | boolean | No | Include archived campaigns when no archived status filter is used. |

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

**Slug:** `MANYREACH_LIST_LISTS`

Return one page of mailing lists available for organizing and importing prospects.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum mailing lists to return on this page (1-1000). |
| `cursor` | string | No | Opaque continuation cursor returned by a previous call; omit for the first page. |

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

**Slug:** `MANYREACH_LIST_MESSAGES`

Retrieve one read-only page of reply, sent, or manually sent messages with campaign, followup, sender, CRM-status, address, and subject filters. This action does not reply to or send messages.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum messages to return in this page (1-1000). |
| `cursor` | string | No | Opaque continuation cursor returned by a previous call. Omit for the first page and pass it back unchanged to continue. |
| `subject` | string | No | Search the message subject. |
| `email_to` | string | No | Search the recipient email address. |
| `sender_id` | integer | No | Only return messages associated with this sender ID. |
| `email_from` | string | No | Search the sender email address. |
| `campaign_id` | integer | No | Only return messages associated with this campaign ID. |
| `followup_id` | integer | No | Only return messages associated with this followup ID. |
| `message_type` | string ("Reply" | "Sent" | "SentManual") | Yes | Message stream to retrieve. Required by ManyReach; choose Reply, Sent, or SentManual. |
| `confirmed_status` | string ("Unknown" | "EspMatchNotFound" | "EspNotAllowed" | "NoWarmup" | "NotReceiving" | "WarmupLimits" | "SendingLimits" | "NoSender" | "Stuck" | "MailboxInexistent" | "EmptySubject" | "EmptyBody" | "MissingPlaceholder" | "Invalid" | "Blacklisted" | "Stopped" | "Unsub" | "BounceHard" | "BounceSoft" | "AutoNolonger" | "AutoOoo" | "AutoReply" | "CollegueReplied" | "SenderDisconnected" | "Paused" | "InsufficientCredit" | "ScheduleInactive" | "NotInterested" | "NotSet" | "Neutral" | "MaybeLater" | "Interested" | "MeetingBooked" | "MeetingCompleted" | "Won" | "Subbed") | No | Only return messages with this exact confirmed CRM status. |

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

**Slug:** `MANYREACH_LIST_PROSPECTS`

Search and filter prospects by identity, CRM status, tags, campaign membership, and existing email-validation verdict. Returns one page at a time.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tags` | array | No | Tag names to match. ManyReach receives these as one comma-separated value. |
| `email` | string | No | Exact email address, useful for resolving a prospect ID. |
| `limit` | integer | No | Maximum prospects to return in this page (1-1000). |
| `cursor` | string | No | Opaque continuation cursor returned by a previous call. Omit for the first page and pass it back unchanged to continue. |
| `search` | string | No | Search prospect email addresses, first names, and last names. |
| `status` | string ("Unknown" | "EspMatchNotFound" | "EspNotAllowed" | "NoWarmup" | "NotReceiving" | "WarmupLimits" | "SendingLimits" | "NoSender" | "Stuck" | "MailboxInexistent" | "EmptySubject" | "EmptyBody" | "MissingPlaceholder" | "Invalid" | "Blacklisted" | "Stopped" | "Unsub" | "BounceHard" | "BounceSoft" | "AutoNolonger" | "AutoOoo" | "AutoReply" | "CollegueReplied" | "SenderDisconnected" | "Paused" | "InsufficientCredit" | "ScheduleInactive" | "NotInterested" | "NotSet" | "Neutral" | "MaybeLater" | "Interested" | "MeetingBooked" | "MeetingCompleted" | "Won" | "Subbed") | No | Exact ManyReach CRM or sending status. |
| `validation_status` | string ("Unvalidated" | "Valid" | "Invalid" | "CatchAll" | "Disposable" | "Unknown") | No | Existing email-validation verdict to match. This does not run billable email validation. |
| `exclude_campaign_ids` | array | No | Exclude prospects belonging to any of these campaign IDs. |
| `include_campaign_ids` | array | No | Only return prospects belonging to any of these campaign IDs. |

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

**Slug:** `MANYREACH_LIST_SENDERS`

Find configured sender mailboxes by folder, connection status, warmup state, or search text. Returns one page without exposing mailbox credentials.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum senders to return on this page (1-1000). |
| `cursor` | string | No | Opaque continuation cursor returned by a previous call; omit for the first page. |
| `folder` | string | No | Only return senders in this folder. |
| `search` | string | No | Search sender first names, last names, and email addresses. |
| `status` | string | No | Only return senders with this connection status, for example error. |
| `warmup` | boolean | No | Filter by whether sender warmup is enabled. |

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

**Slug:** `MANYREACH_LIST_TAGS`

Find CRM, campaign, or sender tags and optionally include prospect counts. Returns one page at a time.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum tags to return on this page (1-1000). |
| `cursor` | string | No | Opaque continuation cursor returned by a previous call; omit for the first page. |
| `search` | string | No | Case-insensitive tag-name search. |
| `tag_type` | string ("Crm" | "Campaign" | "Sender") | No | Only return tags for this resource class: Crm, Campaign, or Sender. |
| `include_prospect_count` | boolean | No | Include the prospect count for each tag. |

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

**Slug:** `MANYREACH_UPDATE_CAMPAIGN`

Update an existing draft campaign's configuration. This tool is draft-only: it does not start, pause, archive, or otherwise activate outreach, and it never sends email.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Campaign name. |
| `subject` | string | No | Subject line for the initial campaign email. |
| `body_html` | string | No | HTML body for the initial campaign email. |
| `folder_id` | integer | No | Positive folder ID used to organize the campaign. |
| `from_name` | string | No | Display name shown in the From field. |
| `campaign_id` | integer | Yes | Existing campaign ID. |
| `daily_limit` | integer | No | Maximum sends per day, from 1 through 10000. |
| `description` | string | No | Campaign purpose or goal. |
| `track_opens` | boolean | No | Enable email-open tracking. |
| `track_clicks` | boolean | No | Enable link-click tracking. |
| `sender_emails` | array | No | Sender email addresses already configured in ManyReach. |
| `reply_to_email` | string | No | Reply-to email address for prospect responses. |
| `daily_limit_per` | string ("Sender" | "Campaign") | No | Apply the daily limit per sender or across the whole campaign. |
| `schedule_sending` | boolean | No | Constrain campaign sending to its configured schedule. |
| `text_only_emails` | boolean | No | Use plain-text email rather than HTML. |
| `delay_min_minutes` | integer | No | Minimum delay between consecutive sends, from 1 through 1440 minutes. |
| `schedule_time_zone` | string | No | IANA time zone for the campaign schedule, such as America/New_York. |
| `use_prospects_time_zone` | boolean | No | Prefer each prospect's known time zone when scheduling. |

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

**Slug:** `MANYREACH_UPDATE_LIST`

Rename or move an existing ManyReach mailing list.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `title` | string | No | New mailing-list title. |
| `list_id` | integer | Yes | Existing positive mailing-list ID. |
| `folder_id` | integer | No | Positive folder ID used to organize the mailing list. |

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

Update contact, personalization, list, CRM, or campaign-sending eligibility fields for one ManyReach prospect by ID. The prospect email cannot be changed. This tool does not send email.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `city` | string | No | City. |
| `notes` | string | No | Internal notes about the prospect. |
| `phone` | string | No | Contact phone number. |
| `state` | string | No | State or province. |
| `domain` | string | No | Company domain. |
| `company` | string | No | Company name. |
| `country` | string | No | Country. |
| `website` | string | No | Company website URL. |
| `industry` | string | No | Company industry. |
| `location` | string | No | Geographic location or address. |
| `last_name` | string | No | Last name used for personalization. |
| `first_name` | string | No | First name used for personalization. |
| `icebreaker` | string | No | Personalized icebreaker. |
| `prospect_id` | integer | Yes | Existing positive prospect ID to update. |
| `base_list_id` | integer | No | Positive mailing-list ID to assign as the prospect's base list. |
| `company_size` | string | No | Company size or employee range. |
| `job_position` | string | No | Job title or position. |
| `custom_fields` | object | No | Personalization values keyed only by custom1 through custom20; each value may contain up to 2000 characters. |
| `company_social` | string | No | Company social-profile URL. |
| `sending_active` | boolean | No | Change whether the prospect is eligible for campaign sending. |
| `sending_status` | string ("Unknown" | "EspMatchNotFound" | "EspNotAllowed" | "NoWarmup" | "NotReceiving" | "WarmupLimits" | "SendingLimits" | "NoSender" | "Stuck" | "MailboxInexistent" | "EmptySubject" | "EmptyBody" | "MissingPlaceholder" | "Invalid" | "Blacklisted" | "Stopped" | "Unsub" | "BounceHard" | "BounceSoft" | "AutoNolonger" | "AutoOoo" | "AutoReply" | "CollegueReplied" | "SenderDisconnected" | "Paused" | "InsufficientCredit" | "ScheduleInactive" | "NotInterested" | "NotSet" | "Neutral" | "MaybeLater" | "Interested" | "MeetingBooked" | "MeetingCompleted" | "Won" | "Subbed") | No | Exact ManyReach campaign-participation status. |
| `personal_social` | string | No | Personal social-profile URL. |

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

**Slug:** `MANYREACH_UPDATE_TAG`

Update an existing tag's title and description. A tag's resource class cannot be changed after creation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `title` | string | No | New tag title. |
| `tag_id` | integer | Yes | Existing positive tag ID. |
| `description` | string | No | Tag purpose or criteria. Use an empty string to clear it. |

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