ManyReach

App · 30 actions

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.

Actions

ActionWhat it does
Blacklist emailsAdd email addresses to the blacklist so no campaign emails them.
Create campaignCreate a draft campaign with its first email, sending mailboxes and sending schedule.
Create prospectAdd one prospect, optionally straight into a list.
Create prospect listCreate an empty prospect list.
Create tagCreate a tag for prospects, campaigns or senders.
Delete campaignDelete a campaign.
Delete prospectDelete a prospect from ManyReach, including every list and campaign.
Delete prospect listDelete a prospect list.
Delete tagDelete a tag.
Get accountGet the ManyReach account the key belongs to, with its remaining sending credits.
Get campaignGet one campaign with its settings, tags and sending counts.
Get campaign statisticsGet a campaign's emails sent, opens, clicks and replies per day, optionally for a date range.
Get prospectGet one prospect with their details, status and tags.
Get prospect listGet one prospect list.
Import prospectsCreate or update many prospects by email at once, and add them to a list or a campaign.
List blacklisted emailsList blacklisted addresses with the entry id needed to remove one.
List campaign prospectsList the prospects enrolled in a campaign with each one's sending status there.
List campaignsList campaigns with their status and counts, optionally only one status.
List messagesList replies received or emails sent, filtered by campaign, mailbox or text.
List prospect listsList the account's prospect lists.
List prospectsFind prospects by search text, exact email or email validation result.
List sending mailboxesList the mailboxes campaigns send from, optionally only disconnected or blacklisted ones.
List tagsList tags, found by name or kind.
Remove blacklisted emailTake one address off the blacklist, by its entry id.
Tag prospectPut a tag on a prospect and return all the prospect's tags.
Untag prospectTake a tag off a prospect.
Update campaignChange a campaign's name, first email, mailboxes or sending schedule.
Update prospectChange a prospect's details.
Update prospect listRename a list or change its description.
Update tagRename a tag or change its description.

Blacklist emails

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

Inputs

Email addressesemailslistRequired
The addresses to blacklist, one per row.

Outputs

addednumber
Addresses newly blacklisted
emailslist
The addresses added
resultslist
Each address with whether it was added, and why not
skippednumber
Addresses not added
Example output
{
  "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

NamenametextRequired
The campaign's name, up to 256 characters.
Descriptiondescriptiontext
A note about the campaign for your team, up to 512 characters.
From namefrom_nametext
The name recipients see the email come from.
Sending mailboxesfrom_emailslist
The mailboxes this campaign sends from.
First email subjectsubjecttext
The subject of the first email. Merge tags like {{FIRSTNAME}} work.
First email bodybodytext
The HTML body of the first email. Put {{SENDER_SIGNATURE}} where the mailbox's signature should appear.
Plain text onlytext_onlytext
Send without HTML formatting. Leave empty to keep ManyReach's default.One of: yes, no.
Track openstrack_openstext
Count opens with a tracking pixel. Leave empty to keep the default.One of: yes, no.
Track clickstrack_clickstext
Count link clicks. Leave empty to keep the default.One of: yes, no.
Add unsubscribe headerunsubscribe_headertext
Add the List-Unsubscribe header. Leave empty to keep the default.One of: yes, no.
Stop teammates when someone repliesstop_on_replytext
Stop other teammates' emails to a prospect once they reply.One of: yes, no.
Daily limitdaily_limitnumber
The most emails the campaign sends a day, 1 to 10000.From 1 to 10000.
Time zonetime_zonetext
The time zone for the sending hours and start. Needed with a start date.
Sending dayssend_dayslist
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 fromsend_fromtime
Earliest time of day to send, on each chosen day.
Send untilsend_untiltime
Latest time of day to send, on each chosen day.
Start onstart_datedate
The date the campaign should start when you start it.
Start atstart_timetime
The time of day on the start date. Defaults to midnight.

Outputs

campaignobject
The campaign just created
Example output
{
  "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

EmailemailtextRequired
The prospect's email address.
Listlist_idnumber
Add the prospect to this list.
First namefirst_nametext
The prospect's first name, for merge tags.
Last namelast_nametext
The prospect's last name.
Companycompanytext
The company they work for.
Job titlejob_positiontext
Their job title.
Phonephonetext
Their phone number.
Websitewebsitetext
The company's website.
Industryindustrytext
The company's industry.
Citycitytext
The city they are in.
State or provincestatetext
The state or province they are in.
Countrycountrytext
The country they are in.
Locationlocationtext
Any other location text, such as an address.
Company sizecompany_sizetext
Company size, such as 11-50 (up to 32 characters).
Company domaindomaintext
The company's domain, such as acme.com.
Company profile linkcompany_socialtext
A link to the company's social profile.
Personal profile linkpersonal_socialtext
A link to their own social profile, such as LinkedIn.
Icebreakericebreakertext
A personal opening line for emails to them, up to 4000 characters.
Notesnotestext
Internal notes about the prospect.
Custom fieldscustom_fieldsobject
Your own values for merge tags, keyed custom1 to custom20, for example {"custom1": "Q4 offer"}.

Outputs

prospectobject
The prospect just created
Example output
{
  "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

TitletitletextRequired
The list's name, up to 256 characters.
Descriptiondescriptiontext
What the list is for, up to 4000 characters.

Outputs

listobject
The list just created
Example output
{
  "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

TitletitletextRequired
The tag's name, up to 128 characters.
Kindtag_typetext
What the tag is for. Defaults to prospects.One of: Crm (Prospect tag), Campaign (Campaign tag), Sender (Sender tag). Default: Crm.
Descriptiondescriptiontext
What the tag means, up to 1000 characters.

Outputs

tagobject
The tag just created
Example output
{
  "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

Campaigncampaign_idnumberRequired
The campaign. Pick one, or give its id from an earlier step.

Outputs

campaign_idnumber
The campaign deleted
deletedtrue/false
Always true once deleted
Example output
{
  "campaign_id": 4821,
  "deleted": true
}

Delete prospect

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

Inputs

Prospect IDprospect_idnumberRequired
The prospect's id, from 'List prospects' or an earlier step.

Outputs

deletedtrue/false
Always true once deleted
prospect_idnumber
The prospect deleted
Example output
{
  "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

Listlist_idnumberRequired
The prospect list. Pick one, or give its id from an earlier step.
Remove its prospects firstforcetrue/false
Take the prospects out of the list, then delete it. Lists over 10,000 prospects are refused.Default: false.

Outputs

deletedtrue/false
Always true once deleted
list_idnumber
The list deleted
Example output
{
  "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

Tagtag_idnumberRequired
The tag. Pick one, or give its id from an earlier step.
Also remove it from everythingforcetrue/false
Take the tag off everything that has it, then delete it.Default: false.

Outputs

deletedtrue/false
Always true once deleted
tag_idnumber
The tag deleted
Example output
{
  "deleted": true,
  "tag_id": 77
}

Get account

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

Inputs

None.

Outputs

accountobject
The connected account
sending_creditsnumber
Sending credits left to spend
Example output
{
  "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

Campaigncampaign_idnumberRequired
The campaign. Pick one, or give its id from an earlier step.

Outputs

campaignobject
The campaign
Example output
{
  "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

Campaigncampaign_idnumberRequired
The campaign. Pick one, or give its id from an earlier step.
Fromdate_startdate
First day to include. Defaults to the campaign's start.
Untildate_enddate
Last day to include. Defaults to today.

Outputs

campaign_idnumber
The campaign
statsobject
Per-day series and totals
Example output
{
  "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 IDprospect_idnumberRequired
The prospect's id, from 'List prospects' or an earlier step.

Outputs

prospectobject
The prospect
Example output
{
  "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

Listlist_idnumberRequired
The prospect list. Pick one, or give its id from an earlier step.

Outputs

listobject
The list
Example output
{
  "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

ProspectsprospectslistRequired
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 listlist_idnumber
Add every prospect to this list.
Add to campaigncampaign_idnumber
Enroll every prospect in this campaign.
Only add new prospectsadd_only_if_newtrue/false
Skip prospects ManyReach already has.Default: false.
Skip prospects in other campaignsskip_if_in_other_campaigntrue/false
Do not enroll prospects who are already in another campaign.Default: false.

Outputs

added_to_campaignnumber
Enrolled in the campaign
added_to_listnumber
Added to the list
duplicates_in_batchnumber
Repeated emails in the batch, ignored
insertednumber
New prospects created
prospect_id_by_emailobject
Each email with its prospect id
prospect_idslist
The ids of the prospects imported
total_processednumber
Prospects read
updatednumber
Existing prospects updated
Example output
{
  "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

Searchsearchtext
Text to find in the address.
Page sizelimitnumber
How many to return, 1 to 1000. ManyReach's default is 100.From 1 to 1000.
Page numberpagenumber
Which page to get, starting at 1.At least 1.
Next page cursorstarting_aftertext
The 'next_cursor' from an earlier page, to get the page after it.

Outputs

countnumber
How many records this page holds
entrieslist
The blacklist entries on this page
next_cursortext
Pass as 'Next page cursor' to get the next page; empty on the last page
pagenumber
This page's number, from 1
totalnumber
How many records match, across all pages
Example output
{
  "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

Campaigncampaign_idnumberRequired
The campaign. Pick one, or give its id from an earlier step.
Still receiving emailssending_activetext
Only prospects who are (Yes) or are not (No) still being emailed.One of: yes, no.
Page sizelimitnumber
How many to return, 1 to 1000. ManyReach's default is 100.From 1 to 1000.
Page numberpagenumber
Which page to get, starting at 1.At least 1.
Next page cursorstarting_aftertext
The 'next_cursor' from an earlier page, to get the page after it.

Outputs

campaign_idnumber
The campaign
countnumber
How many records this page holds
next_cursortext
Pass as 'Next page cursor' to get the next page; empty on the last page
pagenumber
This page's number, from 1
prospectslist
The enrolled prospects on this page
totalnumber
How many records match, across all pages
Example output
{
  "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

Statusstatustext
Only campaigns with this status.One of: draft, scheduled, preparing, running, paused, completed, archived.
Include archivedinclude_archivedtrue/false
Also list archived campaigns.Default: false.
Page sizelimitnumber
How many to return, 1 to 1000. ManyReach's default is 100.From 1 to 1000.
Page numberpagenumber
Which page to get, starting at 1.At least 1.
Next page cursorstarting_aftertext
The 'next_cursor' from an earlier page, to get the page after it.

Outputs

campaignslist
The campaigns on this page
countnumber
How many records this page holds
next_cursortext
Pass as 'Next page cursor' to get the next page; empty on the last page
pagenumber
This page's number, from 1
totalnumber
How many records match, across all pages
Example output
{
  "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

Messagesmessage_typetextRequired
Which messages to list.One of: Reply (Replies received), Sent (Campaign emails sent), SentManual (Emails sent by hand).
Campaigncampaign_idnumber
Only messages of this campaign.
Sending mailboxsender_idnumber
Only messages sent or received by this mailbox.
From containsemail_fromtext
Only messages whose sender address contains this text.
To containsemail_totext
Only messages whose recipient address contains this text.
Subject containssubjecttext
Only messages whose subject contains this text.
Page sizelimitnumber
How many to return, 1 to 1000. ManyReach's default is 100.From 1 to 1000.
Page numberpagenumber
Which page to get, starting at 1.At least 1.
Next page cursorstarting_aftertext
The 'next_cursor' from an earlier page, to get the page after it.

Outputs

countnumber
How many records this page holds
messageslist
The messages on this page
next_cursortext
Pass as 'Next page cursor' to get the next page; empty on the last page
pagenumber
This page's number, from 1
totalnumber
How many records match, across all pages
Example output
{
  "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 sizelimitnumber
How many to return, 1 to 1000. ManyReach's default is 100.From 1 to 1000.
Page numberpagenumber
Which page to get, starting at 1.At least 1.
Next page cursorstarting_aftertext
The 'next_cursor' from an earlier page, to get the page after it.

Outputs

countnumber
How many records this page holds
listslist
The lists on this page
next_cursortext
Pass as 'Next page cursor' to get the next page; empty on the last page
pagenumber
This page's number, from 1
totalnumber
How many records match, across all pages
Example output
{
  "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

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

Outputs

countnumber
How many records this page holds
next_cursortext
Pass as 'Next page cursor' to get the next page; empty on the last page
pagenumber
This page's number, from 1
prospectslist
The prospects on this page
totalnumber
How many records match, across all pages
Example output
{
  "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

Searchsearchtext
Text to find in the mailbox address or name.
Problemstatustext
Only mailboxes that are disconnected or on a blacklist.One of: error (Disconnected), blacklisted (On a blacklist).
Warming upwarmuptext
Only mailboxes with warmup on (Yes) or off (No).One of: yes, no.
Page sizelimitnumber
How many to return, 1 to 1000. ManyReach's default is 100.From 1 to 1000.
Page numberpagenumber
Which page to get, starting at 1.At least 1.
Next page cursorstarting_aftertext
The 'next_cursor' from an earlier page, to get the page after it.

Outputs

countnumber
How many records this page holds
next_cursortext
Pass as 'Next page cursor' to get the next page; empty on the last page
pagenumber
This page's number, from 1
senderslist
The mailboxes on this page
totalnumber
How many records match, across all pages
Example output
{
  "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

Searchsearchtext
Text to find in the tag's name.
Kindtag_typetext
Only tags for prospects, campaigns or senders.One of: Crm (Prospect tag), Campaign (Campaign tag), Sender (Sender tag).
Include prospect countsinclude_prospect_counttrue/false
Add how many prospects have each tag.Default: false.
Page sizelimitnumber
How many to return, 1 to 1000. ManyReach's default is 100.From 1 to 1000.
Page numberpagenumber
Which page to get, starting at 1.At least 1.
Next page cursorstarting_aftertext
The 'next_cursor' from an earlier page, to get the page after it.

Outputs

countnumber
How many records this page holds
next_cursortext
Pass as 'Next page cursor' to get the next page; empty on the last page
pagenumber
This page's number, from 1
tagslist
The tags on this page
totalnumber
How many records match, across all pages
Example output
{
  "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 IDblock_idnumberRequired
The entry's id, from 'List blacklisted emails'.

Outputs

block_idnumber
The entry removed
deletedtrue/false
Always true once deleted
Example output
{
  "block_id": 6001,
  "deleted": true
}

Tag prospect

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

Inputs

Prospect IDprospect_idnumberRequired
The prospect's id, from 'List prospects' or an earlier step.
Tagtag_idnumberRequired
The tag. Pick one, or give its id from an earlier step.

Outputs

countnumber
How many records this page holds
next_cursortext
Pass as 'Next page cursor' to get the next page; empty on the last page
pagenumber
This page's number, from 1
prospect_idnumber
The prospect
tag_idnumber
The tag added
tagslist
All the tags the prospect now has
totalnumber
How many records match, across all pages
Example output
{
  "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 IDprospect_idnumberRequired
The prospect's id, from 'List prospects' or an earlier step.
Tagtag_idnumberRequired
The tag. Pick one, or give its id from an earlier step.

Outputs

deletedtrue/false
Always true once deleted
prospect_idnumber
The prospect
tag_idnumber
The tag removed
Example output
{
  "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

Campaigncampaign_idnumberRequired
The campaign. Pick one, or give its id from an earlier step.
Namenametext
A new name. Leave empty to keep it.
Descriptiondescriptiontext
A note about the campaign for your team, up to 512 characters.
From namefrom_nametext
The name recipients see the email come from.
Sending mailboxesfrom_emailslist
The mailboxes this campaign sends from.
First email subjectsubjecttext
The subject of the first email. Merge tags like {{FIRSTNAME}} work.
First email bodybodytext
The HTML body of the first email. Put {{SENDER_SIGNATURE}} where the mailbox's signature should appear.
Plain text onlytext_onlytext
Send without HTML formatting. Leave empty to keep ManyReach's default.One of: yes, no.
Track openstrack_openstext
Count opens with a tracking pixel. Leave empty to keep the default.One of: yes, no.
Track clickstrack_clickstext
Count link clicks. Leave empty to keep the default.One of: yes, no.
Add unsubscribe headerunsubscribe_headertext
Add the List-Unsubscribe header. Leave empty to keep the default.One of: yes, no.
Stop teammates when someone repliesstop_on_replytext
Stop other teammates' emails to a prospect once they reply.One of: yes, no.
Daily limitdaily_limitnumber
The most emails the campaign sends a day, 1 to 10000.From 1 to 10000.
Time zonetime_zonetext
The time zone for the sending hours and start. Needed with a start date.
Sending dayssend_dayslist
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 fromsend_fromtime
Earliest time of day to send, on each chosen day.
Send untilsend_untiltime
Latest time of day to send, on each chosen day.
Start onstart_datedate
The date the campaign should start when you start it.
Start atstart_timetime
The time of day on the start date. Defaults to midnight.

Outputs

campaignobject
The campaign after the change
Example output
{
  "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 IDprospect_idnumberRequired
The prospect's id, from 'List prospects' or an earlier step.
Receives emailssending_activetext
Yes to email them from campaigns, No to stop. Leave empty to keep it.One of: yes, no.
First namefirst_nametext
The prospect's first name, for merge tags.
Last namelast_nametext
The prospect's last name.
Companycompanytext
The company they work for.
Job titlejob_positiontext
Their job title.
Phonephonetext
Their phone number.
Websitewebsitetext
The company's website.
Industryindustrytext
The company's industry.
Citycitytext
The city they are in.
State or provincestatetext
The state or province they are in.
Countrycountrytext
The country they are in.
Locationlocationtext
Any other location text, such as an address.
Company sizecompany_sizetext
Company size, such as 11-50 (up to 32 characters).
Company domaindomaintext
The company's domain, such as acme.com.
Company profile linkcompany_socialtext
A link to the company's social profile.
Personal profile linkpersonal_socialtext
A link to their own social profile, such as LinkedIn.
Icebreakericebreakertext
A personal opening line for emails to them, up to 4000 characters.
Notesnotestext
Internal notes about the prospect.
Custom fieldscustom_fieldsobject
Your own values for merge tags, keyed custom1 to custom20, for example {"custom1": "Q4 offer"}.

Outputs

prospectobject
The prospect after the change
Example output
{
  "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

Listlist_idnumberRequired
The prospect list. Pick one, or give its id from an earlier step.
Titletitletext
A new title. Leave empty to keep it.
Descriptiondescriptiontext
A new description. Leave empty to keep it.

Outputs

listobject
The list after the change
Example output
{
  "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

Tagtag_idnumberRequired
The tag. Pick one, or give its id from an earlier step.
Titletitletext
A new title. Leave empty to keep it.
Descriptiondescriptiontext
A new description. Leave empty to keep it.

Outputs

tagobject
The tag after the change
Example output
{
  "tag": {
    "createdAt": "2026-10-15T09:00:00Z",
    "description": "Ready to talk",
    "tagId": 77,
    "tagType": "Crm",
    "title": "Hot lead"
  }
}

On this page