# ManyReach

> Run cold email outreach from ManyReach: create and update campaigns, manage prospects, lists and tags, import prospects in bulk, read replies and sent emails, check sending mailboxes and manage the blacklist.

App · 30 actions. Web page: https://docs.lodol.com/docs/integrations/manyreach

## Actions

### Blacklist emails

Add email addresses to the blacklist so no campaign emails them.

**Inputs**

- Email addresses (`emails`, list, required): The addresses to blacklist, one per row.

**Outputs**

- `added` (number): Addresses newly blacklisted
- `emails` (list): The addresses added
- `results` (list): Each address with whether it was added, and why not
- `skipped` (number): Addresses not added

**Example output**

```json
{
  "added": 1,
  "emails": [
    "nobody@example.com"
  ],
  "results": [
    {
      "added": true,
      "email": "nobody@example.com",
      "reason": "Added"
    }
  ],
  "skipped": 0
}
```

### Create campaign

Create a draft campaign with its first email, sending mailboxes and sending schedule. It does not start sending.

**Inputs**

- Name (`name`, text, required): The campaign's name, up to 256 characters.
- Description (`description`, text): A note about the campaign for your team, up to 512 characters.
- From name (`from_name`, text): The name recipients see the email come from.
- Sending mailboxes (`from_emails`, list): The mailboxes this campaign sends from.
- First email subject (`subject`, text): The subject of the first email. Merge tags like {{FIRSTNAME}} work.
- First email body (`body`, text): The HTML body of the first email. Put {{SENDER_SIGNATURE}} where the mailbox's signature should appear.
- Plain text only (`text_only`, text): Send without HTML formatting. Leave empty to keep ManyReach's default. One of: `yes`, `no`.
- Track opens (`track_opens`, text): Count opens with a tracking pixel. Leave empty to keep the default. One of: `yes`, `no`.
- Track clicks (`track_clicks`, text): Count link clicks. Leave empty to keep the default. One of: `yes`, `no`.
- Add unsubscribe header (`unsubscribe_header`, text): Add the List-Unsubscribe header. Leave empty to keep the default. One of: `yes`, `no`.
- Stop teammates when someone replies (`stop_on_reply`, text): Stop other teammates' emails to a prospect once they reply. One of: `yes`, `no`.
- Daily limit (`daily_limit`, number): The most emails the campaign sends a day, 1 to 10000. From 1 to 10000.
- Time zone (`time_zone`, text): The time zone for the sending hours and start. Needed with a start date.
- Sending days (`send_days`, list): The weekdays emails may go out. Days not picked are switched off. One or more of: `mon` (Monday), `tue` (Tuesday), `wed` (Wednesday), `thu` (Thursday), `fri` (Friday), `sat` (Saturday), `sun` (Sunday).
- Send from (`send_from`, time): Earliest time of day to send, on each chosen day.
- Send until (`send_until`, time): Latest time of day to send, on each chosen day.
- Start on (`start_date`, date): The date the campaign should start when you start it.
- Start at (`start_time`, time): The time of day on the start date. Defaults to midnight.

**Outputs**

- `campaign` (object): The campaign just created

**Example output**

```json
{
  "campaign": {
    "activeProspectCount": 0,
    "body": "<p>Hi {{FIRSTNAME}}</p>",
    "bounceCount": 0,
    "campaignId": 4821,
    "clickCount": 0,
    "createdAt": "2026-10-15T09:00:00Z",
    "dailyLimit": 100,
    "description": "Autumn push",
    "folderId": 1,
    "fromEmails": "jo@acme.com",
    "fromName": "Jo from Acme",
    "interestedCount": 0,
    "name": "Q4 outreach",
    "openCount": 0,
    "prospectCount": 0,
    "replyCount": 0,
    "scheduleSendOnDate": "2026-12-01",
    "scheduleSendOnDateEnabled": false,
    "scheduleSendOnDateHours": 8,
    "scheduleSendOnDateMinutes": 0,
    "scheduleSending": true,
    "scheduleTimeZone": "America/New_York",
    "sendFri": true,
    "sendMon": true,
    "sendSat": false,
    "sendSun": false,
    "sendThu": true,
    "sendTue": true,
    "sendUnsubscribeListHeader": true,
    "sendWed": true,
    "sentCount": 0,
    "status": "Draft",
    "stopCoworkersOnReply": true,
    "subject": "Quick question",
    "tags": [],
    "textOnlyEmails": false,
    "trackClicks": false,
    "trackOpens": true
  }
}
```

### Create prospect

Add one prospect, optionally straight into a list.

**Inputs**

- Email (`email`, text, required): The prospect's email address.
- List (`list_id`, number): Add the prospect to this list.
- First name (`first_name`, text): The prospect's first name, for merge tags.
- Last name (`last_name`, text): The prospect's last name.
- Company (`company`, text): The company they work for.
- Job title (`job_position`, text): Their job title.
- Phone (`phone`, text): Their phone number.
- Website (`website`, text): The company's website.
- Industry (`industry`, text): The company's industry.
- City (`city`, text): The city they are in.
- State or province (`state`, text): The state or province they are in.
- Country (`country`, text): The country they are in.
- Location (`location`, text): Any other location text, such as an address.
- Company size (`company_size`, text): Company size, such as 11-50 (up to 32 characters).
- Company domain (`domain`, text): The company's domain, such as acme.com.
- Company profile link (`company_social`, text): A link to the company's social profile.
- Personal profile link (`personal_social`, text): A link to their own social profile, such as LinkedIn.
- Icebreaker (`icebreaker`, text): A personal opening line for emails to them, up to 4000 characters.
- Notes (`notes`, text): Internal notes about the prospect.
- Custom fields (`custom_fields`, object): Your own values for merge tags, keyed custom1 to custom20, for example {"custom1": "Q4 offer"}.

**Outputs**

- `prospect` (object): The prospect just created

**Example output**

```json
{
  "prospect": {
    "baseListId": 311,
    "city": "Boston",
    "company": "Acme",
    "country": "USA",
    "createdAt": "2026-10-15T09:00:00Z",
    "custom1": "Q4 offer",
    "custom2": "",
    "email": "jo@example.com",
    "firstName": "Jo",
    "icebreaker": "Loved your talk.",
    "industry": "Software",
    "jobPosition": "Head of Sales",
    "lastName": "Bloggs",
    "location": "Boston, MA",
    "notes": "",
    "phone": "+15555550100",
    "prospectId": 90210,
    "sendingActive": true,
    "sendingStatus": "NotSet",
    "state": "MA",
    "tags": [
      {
        "id": 77,
        "name": "Hot"
      }
    ],
    "validatedAt": "2026-10-15T09:05:00Z",
    "validationStatus": "Valid",
    "website": "https://acme.com"
  }
}
```

### Create prospect list

Create an empty prospect list.

**Inputs**

- Title (`title`, text, required): The list's name, up to 256 characters.
- Description (`description`, text): What the list is for, up to 4000 characters.

**Outputs**

- `list` (object): The list just created

**Example output**

```json
{
  "list": {
    "createdAt": "2026-10-15T09:00:00Z",
    "description": "Met at the autumn show",
    "folderId": 1,
    "listId": 311,
    "title": "Conference leads"
  }
}
```

### Create tag

Create a tag for prospects, campaigns or senders.

**Inputs**

- Title (`title`, text, required): The tag's name, up to 128 characters.
- Kind (`tag_type`, text): What the tag is for. Defaults to prospects. One of: `Crm` (Prospect tag), `Campaign` (Campaign tag), `Sender` (Sender tag). Default: `Crm`.
- Description (`description`, text): What the tag means, up to 1000 characters.

**Outputs**

- `tag` (object): The tag just created

**Example output**

```json
{
  "tag": {
    "createdAt": "2026-10-15T09:00:00Z",
    "description": "Ready to talk",
    "tagId": 77,
    "tagType": "Crm",
    "title": "Hot"
  }
}
```

### Delete campaign

Delete a campaign. Its prospects stay in ManyReach.

**Inputs**

- Campaign (`campaign_id`, number, required): The campaign. Pick one, or give its id from an earlier step.

**Outputs**

- `campaign_id` (number): The campaign deleted
- `deleted` (true/false): Always true once deleted

**Example output**

```json
{
  "campaign_id": 4821,
  "deleted": true
}
```

### Delete prospect

Delete a prospect from ManyReach, including every list and campaign.

**Inputs**

- Prospect ID (`prospect_id`, number, required): The prospect's id, from 'List prospects' or an earlier step.

**Outputs**

- `deleted` (true/false): Always true once deleted
- `prospect_id` (number): The prospect deleted

**Example output**

```json
{
  "deleted": true,
  "prospect_id": 90210
}
```

### Delete prospect list

Delete a prospect list. The prospects in it are kept; without 'Remove its prospects first' a list that still has prospects is refused.

**Inputs**

- List (`list_id`, number, required): The prospect list. Pick one, or give its id from an earlier step.
- Remove its prospects first (`force`, true/false): Take the prospects out of the list, then delete it. Lists over 10,000 prospects are refused. Default: `false`.

**Outputs**

- `deleted` (true/false): Always true once deleted
- `list_id` (number): The list deleted

**Example output**

```json
{
  "deleted": true,
  "list_id": 311
}
```

### Delete tag

Delete a tag. A tag still on prospects, campaigns or senders is refused unless 'Also remove it from everything' is on.

**Inputs**

- Tag (`tag_id`, number, required): The tag. Pick one, or give its id from an earlier step.
- Also remove it from everything (`force`, true/false): Take the tag off everything that has it, then delete it. Default: `false`.

**Outputs**

- `deleted` (true/false): Always true once deleted
- `tag_id` (number): The tag deleted

**Example output**

```json
{
  "deleted": true,
  "tag_id": 77
}
```

### Get account

Get the ManyReach account the key belongs to, with its remaining sending credits.

**Inputs**: None.

**Outputs**

- `account` (object): The connected account
- `sending_credits` (number): Sending credits left to spend

**Example output**

```json
{
  "account": {
    "createdAt": "2025-01-10T09:00:00Z",
    "id": 1234,
    "keyType": "organization",
    "parentOrganization": {
      "id": 1,
      "title": "Acme Agency"
    },
    "title": "Acme Outreach"
  },
  "sending_credits": 4200
}
```

### Get campaign

Get one campaign with its settings, tags and sending counts.

**Inputs**

- Campaign (`campaign_id`, number, required): The campaign. Pick one, or give its id from an earlier step.

**Outputs**

- `campaign` (object): The campaign

**Example output**

```json
{
  "campaign": {
    "activeProspectCount": 0,
    "body": "<p>Hi {{FIRSTNAME}}</p>",
    "bounceCount": 0,
    "campaignId": 4821,
    "clickCount": 0,
    "createdAt": "2026-10-15T09:00:00Z",
    "dailyLimit": 100,
    "description": "Autumn push",
    "folderId": 1,
    "fromEmails": "jo@acme.com",
    "fromName": "Jo from Acme",
    "interestedCount": 0,
    "name": "Q4 outreach",
    "openCount": 0,
    "prospectCount": 0,
    "replyCount": 0,
    "scheduleSendOnDate": "2026-12-01",
    "scheduleSendOnDateEnabled": false,
    "scheduleSendOnDateHours": 8,
    "scheduleSendOnDateMinutes": 0,
    "scheduleSending": true,
    "scheduleTimeZone": "America/New_York",
    "sendFri": true,
    "sendMon": true,
    "sendSat": false,
    "sendSun": false,
    "sendThu": true,
    "sendTue": true,
    "sendUnsubscribeListHeader": true,
    "sendWed": true,
    "sentCount": 0,
    "status": "Draft",
    "stopCoworkersOnReply": true,
    "subject": "Quick question",
    "tags": [],
    "textOnlyEmails": false,
    "trackClicks": false,
    "trackOpens": true
  }
}
```

### Get campaign statistics

Get a campaign's emails sent, opens, clicks and replies per day, optionally for a date range.

**Inputs**

- Campaign (`campaign_id`, number, required): The campaign. Pick one, or give its id from an earlier step.
- From (`date_start`, date): First day to include. Defaults to the campaign's start.
- Until (`date_end`, date): Last day to include. Defaults to today.

**Outputs**

- `campaign_id` (number): The campaign
- `stats` (object): Per-day series and totals

**Example output**

```json
{
  "campaign_id": 4821,
  "stats": {
    "campaignId": 4821,
    "clicksSeries": {
      "total": 0,
      "values": [
        0
      ]
    },
    "followupStats": [],
    "opensSeries": {
      "total": 0,
      "values": [
        0
      ]
    },
    "replySeries": {
      "total": 0,
      "values": [
        0
      ]
    },
    "sentInitialSeries": {
      "total": 0,
      "values": [
        0
      ]
    },
    "sentSeries": {
      "total": 0,
      "values": [
        0
      ]
    },
    "timeline": [
      "2026-10-15"
    ],
    "unspamSeries": {
      "total": 0,
      "values": [
        0
      ]
    }
  }
}
```

### Get prospect

Get one prospect with their details, status and tags.

**Inputs**

- Prospect ID (`prospect_id`, number, required): The prospect's id, from 'List prospects' or an earlier step.

**Outputs**

- `prospect` (object): The prospect

**Example output**

```json
{
  "prospect": {
    "baseListId": 311,
    "city": "Boston",
    "company": "Acme",
    "country": "USA",
    "createdAt": "2026-10-15T09:00:00Z",
    "custom1": "Q4 offer",
    "custom2": "",
    "email": "jo@example.com",
    "firstName": "Jo",
    "icebreaker": "Loved your talk.",
    "industry": "Software",
    "jobPosition": "Head of Sales",
    "lastName": "Bloggs",
    "location": "Boston, MA",
    "notes": "",
    "phone": "+15555550100",
    "prospectId": 90210,
    "sendingActive": true,
    "sendingStatus": "NotSet",
    "state": "MA",
    "tags": [
      {
        "id": 77,
        "name": "Hot"
      }
    ],
    "validatedAt": "2026-10-15T09:05:00Z",
    "validationStatus": "Valid",
    "website": "https://acme.com"
  }
}
```

### Get prospect list

Get one prospect list.

**Inputs**

- List (`list_id`, number, required): The prospect list. Pick one, or give its id from an earlier step.

**Outputs**

- `list` (object): The list

**Example output**

```json
{
  "list": {
    "createdAt": "2026-10-15T09:00:00Z",
    "description": "Met at the autumn show",
    "folderId": 1,
    "listId": 311,
    "title": "Conference leads"
  }
}
```

### Import prospects

Create or update many prospects by email at once, and add them to a list or a campaign.

**Inputs**

- Prospects (`prospects`, list, required): The prospects, each with an email and any of first_name, last_name, company, job_position, phone, website, industry, city, state, country, location, company_size, domain, icebreaker, notes or custom1 to custom20. Or a list from an earlier step.
- Add to list (`list_id`, number): Add every prospect to this list.
- Add to campaign (`campaign_id`, number): Enroll every prospect in this campaign.
- Only add new prospects (`add_only_if_new`, true/false): Skip prospects ManyReach already has. Default: `false`.
- Skip prospects in other campaigns (`skip_if_in_other_campaign`, true/false): Do not enroll prospects who are already in another campaign. Default: `false`.

**Outputs**

- `added_to_campaign` (number): Enrolled in the campaign
- `added_to_list` (number): Added to the list
- `duplicates_in_batch` (number): Repeated emails in the batch, ignored
- `inserted` (number): New prospects created
- `prospect_id_by_email` (object): Each email with its prospect id
- `prospect_ids` (list): The ids of the prospects imported
- `total_processed` (number): Prospects read
- `updated` (number): Existing prospects updated

**Example output**

```json
{
  "added_to_campaign": 0,
  "added_to_list": 1,
  "duplicates_in_batch": 0,
  "inserted": 1,
  "prospect_id_by_email": {
    "jo@example.com": 90210
  },
  "prospect_ids": [
    90210
  ],
  "total_processed": 1,
  "updated": 0
}
```

### List blacklisted emails

List blacklisted addresses with the entry id needed to remove one. Gets one page.

**Inputs**

- Search (`search`, text): Text to find in the address.
- Page size (`limit`, number): How many to return, 1 to 1000. ManyReach's default is 100. From 1 to 1000.
- Page number (`page`, number): Which page to get, starting at 1. At least 1.
- Next page cursor (`starting_after`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `count` (number): How many records this page holds
- `entries` (list): The blacklist entries on this page
- `next_cursor` (text): Pass as 'Next page cursor' to get the next page; empty on the last page
- `page` (number): This page's number, from 1
- `total` (number): How many records match, across all pages

**Example output**

```json
{
  "count": 1,
  "entries": [
    {
      "blockId": 6001,
      "createdAt": "2026-10-15T09:00:00Z",
      "email": "nobody@example.com"
    }
  ],
  "next_cursor": "",
  "page": 1,
  "total": 1
}
```

### List campaign prospects

List the prospects enrolled in a campaign with each one's sending status there. Gets one page.

**Inputs**

- Campaign (`campaign_id`, number, required): The campaign. Pick one, or give its id from an earlier step.
- Still receiving emails (`sending_active`, text): Only prospects who are (Yes) or are not (No) still being emailed. One of: `yes`, `no`.
- Page size (`limit`, number): How many to return, 1 to 1000. ManyReach's default is 100. From 1 to 1000.
- Page number (`page`, number): Which page to get, starting at 1. At least 1.
- Next page cursor (`starting_after`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `campaign_id` (number): The campaign
- `count` (number): How many records this page holds
- `next_cursor` (text): Pass as 'Next page cursor' to get the next page; empty on the last page
- `page` (number): This page's number, from 1
- `prospects` (list): The enrolled prospects on this page
- `total` (number): How many records match, across all pages

**Example output**

```json
{
  "campaign_id": 4821,
  "count": 1,
  "next_cursor": "",
  "page": 1,
  "prospects": [
    {
      "addedAt": "2026-10-15T09:00:00Z",
      "bounced": false,
      "campaignId": 4821,
      "company": "Acme",
      "email": "jo@example.com",
      "enrollmentId": 1001,
      "firstName": "Jo",
      "firstSentAt": "2026-10-16T09:00:00Z",
      "lastName": "Bloggs",
      "prospectId": 90210,
      "replied": false,
      "sendingActive": true,
      "sendingStatus": "NotSet",
      "sent": false,
      "sentCount": 0,
      "statusReason": "Waiting for the first email"
    }
  ],
  "total": 1
}
```

### List campaigns

List campaigns with their status and counts, optionally only one status. Gets one page; to see more, run it again with the next page.

**Inputs**

- Status (`status`, text): Only campaigns with this status. One of: `draft`, `scheduled`, `preparing`, `running`, `paused`, `completed`, `archived`.
- Include archived (`include_archived`, true/false): Also list archived campaigns. Default: `false`.
- Page size (`limit`, number): How many to return, 1 to 1000. ManyReach's default is 100. From 1 to 1000.
- Page number (`page`, number): Which page to get, starting at 1. At least 1.
- Next page cursor (`starting_after`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `campaigns` (list): The campaigns on this page
- `count` (number): How many records this page holds
- `next_cursor` (text): Pass as 'Next page cursor' to get the next page; empty on the last page
- `page` (number): This page's number, from 1
- `total` (number): How many records match, across all pages

**Example output**

```json
{
  "campaigns": [
    {
      "activeProspectCount": 0,
      "body": "<p>Hi {{FIRSTNAME}}</p>",
      "bounceCount": 0,
      "campaignId": 4821,
      "clickCount": 0,
      "createdAt": "2026-10-15T09:00:00Z",
      "dailyLimit": 100,
      "description": "Autumn push",
      "folderId": 1,
      "fromEmails": "jo@acme.com",
      "fromName": "Jo from Acme",
      "interestedCount": 0,
      "name": "Q4 outreach",
      "openCount": 0,
      "prospectCount": 0,
      "replyCount": 0,
      "scheduleSendOnDate": "2026-12-01",
      "scheduleSendOnDateEnabled": false,
      "scheduleSendOnDateHours": 8,
      "scheduleSendOnDateMinutes": 0,
      "scheduleSending": true,
      "scheduleTimeZone": "America/New_York",
      "sendFri": true,
      "sendMon": true,
      "sendSat": false,
      "sendSun": false,
      "sendThu": true,
      "sendTue": true,
      "sendUnsubscribeListHeader": true,
      "sendWed": true,
      "sentCount": 0,
      "status": "Draft",
      "stopCoworkersOnReply": true,
      "subject": "Quick question",
      "tags": [],
      "textOnlyEmails": false,
      "trackClicks": false,
      "trackOpens": true
    }
  ],
  "count": 1,
  "next_cursor": "",
  "page": 1,
  "total": 1
}
```

### List messages

List replies received or emails sent, filtered by campaign, mailbox or text. Gets one page.

**Inputs**

- Messages (`message_type`, text, required): Which messages to list. One of: `Reply` (Replies received), `Sent` (Campaign emails sent), `SentManual` (Emails sent by hand).
- Campaign (`campaign_id`, number): Only messages of this campaign.
- Sending mailbox (`sender_id`, number): Only messages sent or received by this mailbox.
- From contains (`email_from`, text): Only messages whose sender address contains this text.
- To contains (`email_to`, text): Only messages whose recipient address contains this text.
- Subject contains (`subject`, text): Only messages whose subject contains this text.
- Page size (`limit`, number): How many to return, 1 to 1000. ManyReach's default is 100. From 1 to 1000.
- Page number (`page`, number): Which page to get, starting at 1. At least 1.
- Next page cursor (`starting_after`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `count` (number): How many records this page holds
- `messages` (list): The messages on this page
- `next_cursor` (text): Pass as 'Next page cursor' to get the next page; empty on the last page
- `page` (number): This page's number, from 1
- `total` (number): How many records match, across all pages

**Example output**

```json
{
  "count": 1,
  "messages": [
    {
      "body": "Sounds interesting.",
      "campaignId": 4821,
      "clickCount": 0,
      "createdAt": "2026-10-16T14:00:00Z",
      "followupId": 0,
      "fromEmail": "jo@example.com",
      "messageId": "msg_8f2c",
      "openCount": 0,
      "senderId": 55,
      "subject": "Re: Quick question",
      "toEmail": "jo@acme.com",
      "type": "Reply"
    }
  ],
  "next_cursor": "",
  "page": 1,
  "total": 1
}
```

### List prospect lists

List the account's prospect lists. Gets one page.

**Inputs**

- Page size (`limit`, number): How many to return, 1 to 1000. ManyReach's default is 100. From 1 to 1000.
- Page number (`page`, number): Which page to get, starting at 1. At least 1.
- Next page cursor (`starting_after`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `count` (number): How many records this page holds
- `lists` (list): The lists on this page
- `next_cursor` (text): Pass as 'Next page cursor' to get the next page; empty on the last page
- `page` (number): This page's number, from 1
- `total` (number): How many records match, across all pages

**Example output**

```json
{
  "count": 1,
  "lists": [
    {
      "createdAt": "2026-10-15T09:00:00Z",
      "description": "Met at the autumn show",
      "folderId": 1,
      "listId": 311,
      "title": "Conference leads"
    }
  ],
  "next_cursor": "",
  "page": 1,
  "total": 1
}
```

### List prospects

Find prospects by search text, exact email or email validation result. Gets one page.

**Inputs**

- Search (`search`, text): Text to find in the email, first name or last name.
- Exact email (`email`, text): Find the prospect with exactly this email address.
- Email check result (`validation_status`, text): Only prospects whose email was checked with this result. One of: `Valid`, `Invalid`, `CatchAll` (Catch-all), `Disposable`, `Unknown`, `Unvalidated` (Not checked yet).
- Page size (`limit`, number): How many to return, 1 to 1000. ManyReach's default is 100. From 1 to 1000.
- Page number (`page`, number): Which page to get, starting at 1. At least 1.
- Next page cursor (`starting_after`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `count` (number): How many records this page holds
- `next_cursor` (text): Pass as 'Next page cursor' to get the next page; empty on the last page
- `page` (number): This page's number, from 1
- `prospects` (list): The prospects on this page
- `total` (number): How many records match, across all pages

**Example output**

```json
{
  "count": 1,
  "next_cursor": "",
  "page": 1,
  "prospects": [
    {
      "baseListId": 311,
      "city": "Boston",
      "company": "Acme",
      "country": "USA",
      "createdAt": "2026-10-15T09:00:00Z",
      "custom1": "Q4 offer",
      "custom2": "",
      "email": "jo@example.com",
      "firstName": "Jo",
      "icebreaker": "Loved your talk.",
      "industry": "Software",
      "jobPosition": "Head of Sales",
      "lastName": "Bloggs",
      "location": "Boston, MA",
      "notes": "",
      "phone": "+15555550100",
      "prospectId": 90210,
      "sendingActive": true,
      "sendingStatus": "NotSet",
      "state": "MA",
      "tags": [
        {
          "id": 77,
          "name": "Hot"
        }
      ],
      "validatedAt": "2026-10-15T09:05:00Z",
      "validationStatus": "Valid",
      "website": "https://acme.com"
    }
  ],
  "total": 1
}
```

### List sending mailboxes

List the mailboxes campaigns send from, optionally only disconnected or blacklisted ones. Gets one page.

**Inputs**

- Search (`search`, text): Text to find in the mailbox address or name.
- Problem (`status`, text): Only mailboxes that are disconnected or on a blacklist. One of: `error` (Disconnected), `blacklisted` (On a blacklist).
- Warming up (`warmup`, text): Only mailboxes with warmup on (Yes) or off (No). One of: `yes`, `no`.
- Page size (`limit`, number): How many to return, 1 to 1000. ManyReach's default is 100. From 1 to 1000.
- Page number (`page`, number): Which page to get, starting at 1. At least 1.
- Next page cursor (`starting_after`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `count` (number): How many records this page holds
- `next_cursor` (text): Pass as 'Next page cursor' to get the next page; empty on the last page
- `page` (number): This page's number, from 1
- `senders` (list): The mailboxes on this page
- `total` (number): How many records match, across all pages

**Example output**

```json
{
  "count": 1,
  "next_cursor": "",
  "page": 1,
  "senders": [
    {
      "accountType": "GmailOauth",
      "createdAt": "2026-09-01T09:00:00Z",
      "dailyLimit": 40,
      "dateDisconnected": "2026-10-01T00:00:00Z",
      "disconnected": false,
      "disconnectionReason": "None",
      "email": "jo@acme.com",
      "firstName": "Jo",
      "folder": "Sales",
      "fromName": "Jo from Acme",
      "lastName": "Bloggs",
      "replyTo": "reply@acme.com",
      "senderId": 55,
      "signature": "Jo",
      "tags": [],
      "warmup": true,
      "warmupDailyLimit": 20,
      "warmupReplyPercent": 30
    }
  ],
  "total": 1
}
```

### List tags

List tags, found by name or kind. Gets one page.

**Inputs**

- Search (`search`, text): Text to find in the tag's name.
- Kind (`tag_type`, text): Only tags for prospects, campaigns or senders. One of: `Crm` (Prospect tag), `Campaign` (Campaign tag), `Sender` (Sender tag).
- Include prospect counts (`include_prospect_count`, true/false): Add how many prospects have each tag. Default: `false`.
- Page size (`limit`, number): How many to return, 1 to 1000. ManyReach's default is 100. From 1 to 1000.
- Page number (`page`, number): Which page to get, starting at 1. At least 1.
- Next page cursor (`starting_after`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `count` (number): How many records this page holds
- `next_cursor` (text): Pass as 'Next page cursor' to get the next page; empty on the last page
- `page` (number): This page's number, from 1
- `tags` (list): The tags on this page
- `total` (number): How many records match, across all pages

**Example output**

```json
{
  "count": 1,
  "next_cursor": "",
  "page": 1,
  "tags": [
    {
      "createdAt": "2026-10-15T09:00:00Z",
      "description": "Ready to talk",
      "tagId": 77,
      "tagType": "Crm",
      "title": "Hot"
    }
  ],
  "total": 1
}
```

### Remove blacklisted email

Take one address off the blacklist, by its entry id.

**Inputs**

- Entry ID (`block_id`, number, required): The entry's id, from 'List blacklisted emails'.

**Outputs**

- `block_id` (number): The entry removed
- `deleted` (true/false): Always true once deleted

**Example output**

```json
{
  "block_id": 6001,
  "deleted": true
}
```

### Tag prospect

Put a tag on a prospect and return all the prospect's tags.

**Inputs**

- Prospect ID (`prospect_id`, number, required): The prospect's id, from 'List prospects' or an earlier step.
- Tag (`tag_id`, number, required): The tag. Pick one, or give its id from an earlier step.

**Outputs**

- `count` (number): How many records this page holds
- `next_cursor` (text): Pass as 'Next page cursor' to get the next page; empty on the last page
- `page` (number): This page's number, from 1
- `prospect_id` (number): The prospect
- `tag_id` (number): The tag added
- `tags` (list): All the tags the prospect now has
- `total` (number): How many records match, across all pages

**Example output**

```json
{
  "count": 1,
  "next_cursor": "",
  "page": 1,
  "prospect_id": 90210,
  "tag_id": 77,
  "tags": [
    {
      "createdAt": "2026-10-15T09:00:00Z",
      "description": "Ready to talk",
      "tagId": 77,
      "tagType": "Crm",
      "title": "Hot"
    }
  ],
  "total": 1
}
```

### Untag prospect

Take a tag off a prospect.

**Inputs**

- Prospect ID (`prospect_id`, number, required): The prospect's id, from 'List prospects' or an earlier step.
- Tag (`tag_id`, number, required): The tag. Pick one, or give its id from an earlier step.

**Outputs**

- `deleted` (true/false): Always true once deleted
- `prospect_id` (number): The prospect
- `tag_id` (number): The tag removed

**Example output**

```json
{
  "deleted": true,
  "prospect_id": 90210,
  "tag_id": 77
}
```

### Update campaign

Change a campaign's name, first email, mailboxes or sending schedule. Fields left empty stay as they are.

**Inputs**

- Campaign (`campaign_id`, number, required): The campaign. Pick one, or give its id from an earlier step.
- Name (`name`, text): A new name. Leave empty to keep it.
- Description (`description`, text): A note about the campaign for your team, up to 512 characters.
- From name (`from_name`, text): The name recipients see the email come from.
- Sending mailboxes (`from_emails`, list): The mailboxes this campaign sends from.
- First email subject (`subject`, text): The subject of the first email. Merge tags like {{FIRSTNAME}} work.
- First email body (`body`, text): The HTML body of the first email. Put {{SENDER_SIGNATURE}} where the mailbox's signature should appear.
- Plain text only (`text_only`, text): Send without HTML formatting. Leave empty to keep ManyReach's default. One of: `yes`, `no`.
- Track opens (`track_opens`, text): Count opens with a tracking pixel. Leave empty to keep the default. One of: `yes`, `no`.
- Track clicks (`track_clicks`, text): Count link clicks. Leave empty to keep the default. One of: `yes`, `no`.
- Add unsubscribe header (`unsubscribe_header`, text): Add the List-Unsubscribe header. Leave empty to keep the default. One of: `yes`, `no`.
- Stop teammates when someone replies (`stop_on_reply`, text): Stop other teammates' emails to a prospect once they reply. One of: `yes`, `no`.
- Daily limit (`daily_limit`, number): The most emails the campaign sends a day, 1 to 10000. From 1 to 10000.
- Time zone (`time_zone`, text): The time zone for the sending hours and start. Needed with a start date.
- Sending days (`send_days`, list): The weekdays emails may go out. Days not picked are switched off. One or more of: `mon` (Monday), `tue` (Tuesday), `wed` (Wednesday), `thu` (Thursday), `fri` (Friday), `sat` (Saturday), `sun` (Sunday).
- Send from (`send_from`, time): Earliest time of day to send, on each chosen day.
- Send until (`send_until`, time): Latest time of day to send, on each chosen day.
- Start on (`start_date`, date): The date the campaign should start when you start it.
- Start at (`start_time`, time): The time of day on the start date. Defaults to midnight.

**Outputs**

- `campaign` (object): The campaign after the change

**Example output**

```json
{
  "campaign": {
    "activeProspectCount": 0,
    "body": "<p>Hi {{FIRSTNAME}}</p>",
    "bounceCount": 0,
    "campaignId": 4821,
    "clickCount": 0,
    "createdAt": "2026-10-15T09:00:00Z",
    "dailyLimit": 100,
    "description": "Autumn push",
    "folderId": 1,
    "fromEmails": "jo@acme.com",
    "fromName": "Jo from Acme",
    "interestedCount": 0,
    "name": "Q4 outreach v2",
    "openCount": 0,
    "prospectCount": 0,
    "replyCount": 0,
    "scheduleSendOnDate": "2026-12-01",
    "scheduleSendOnDateEnabled": false,
    "scheduleSendOnDateHours": 8,
    "scheduleSendOnDateMinutes": 0,
    "scheduleSending": true,
    "scheduleTimeZone": "America/New_York",
    "sendFri": true,
    "sendMon": true,
    "sendSat": false,
    "sendSun": false,
    "sendThu": true,
    "sendTue": true,
    "sendUnsubscribeListHeader": true,
    "sendWed": true,
    "sentCount": 0,
    "status": "Draft",
    "stopCoworkersOnReply": true,
    "subject": "Quick question",
    "tags": [],
    "textOnlyEmails": false,
    "trackClicks": false,
    "trackOpens": true
  }
}
```

### Update prospect

Change a prospect's details. Fields left empty stay as they are.

**Inputs**

- Prospect ID (`prospect_id`, number, required): The prospect's id, from 'List prospects' or an earlier step.
- Receives emails (`sending_active`, text): Yes to email them from campaigns, No to stop. Leave empty to keep it. One of: `yes`, `no`.
- First name (`first_name`, text): The prospect's first name, for merge tags.
- Last name (`last_name`, text): The prospect's last name.
- Company (`company`, text): The company they work for.
- Job title (`job_position`, text): Their job title.
- Phone (`phone`, text): Their phone number.
- Website (`website`, text): The company's website.
- Industry (`industry`, text): The company's industry.
- City (`city`, text): The city they are in.
- State or province (`state`, text): The state or province they are in.
- Country (`country`, text): The country they are in.
- Location (`location`, text): Any other location text, such as an address.
- Company size (`company_size`, text): Company size, such as 11-50 (up to 32 characters).
- Company domain (`domain`, text): The company's domain, such as acme.com.
- Company profile link (`company_social`, text): A link to the company's social profile.
- Personal profile link (`personal_social`, text): A link to their own social profile, such as LinkedIn.
- Icebreaker (`icebreaker`, text): A personal opening line for emails to them, up to 4000 characters.
- Notes (`notes`, text): Internal notes about the prospect.
- Custom fields (`custom_fields`, object): Your own values for merge tags, keyed custom1 to custom20, for example {"custom1": "Q4 offer"}.

**Outputs**

- `prospect` (object): The prospect after the change

**Example output**

```json
{
  "prospect": {
    "baseListId": 311,
    "city": "Boston",
    "company": "Acme Inc",
    "country": "USA",
    "createdAt": "2026-10-15T09:00:00Z",
    "custom1": "Q4 offer",
    "custom2": "",
    "email": "jo@example.com",
    "firstName": "Jo",
    "icebreaker": "Loved your talk.",
    "industry": "Software",
    "jobPosition": "Head of Sales",
    "lastName": "Bloggs",
    "location": "Boston, MA",
    "notes": "",
    "phone": "+15555550100",
    "prospectId": 90210,
    "sendingActive": true,
    "sendingStatus": "NotSet",
    "state": "MA",
    "tags": [
      {
        "id": 77,
        "name": "Hot"
      }
    ],
    "validatedAt": "2026-10-15T09:05:00Z",
    "validationStatus": "Valid",
    "website": "https://acme.com"
  }
}
```

### Update prospect list

Rename a list or change its description.

**Inputs**

- List (`list_id`, number, required): The prospect list. Pick one, or give its id from an earlier step.
- Title (`title`, text): A new title. Leave empty to keep it.
- Description (`description`, text): A new description. Leave empty to keep it.

**Outputs**

- `list` (object): The list after the change

**Example output**

```json
{
  "list": {
    "createdAt": "2026-10-15T09:00:00Z",
    "description": "Met at the autumn show",
    "folderId": 1,
    "listId": 311,
    "title": "Conference leads 2026"
  }
}
```

### Update tag

Rename a tag or change its description.

**Inputs**

- Tag (`tag_id`, number, required): The tag. Pick one, or give its id from an earlier step.
- Title (`title`, text): A new title. Leave empty to keep it.
- Description (`description`, text): A new description. Leave empty to keep it.

**Outputs**

- `tag` (object): The tag after the change

**Example output**

```json
{
  "tag": {
    "createdAt": "2026-10-15T09:00:00Z",
    "description": "Ready to talk",
    "tagId": 77,
    "tagType": "Crm",
    "title": "Hot lead"
  }
}
```
