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
| Action | What it does |
|---|---|
| Blacklist emails | Add email addresses to the blacklist so no campaign emails them. |
| Create campaign | Create a draft campaign with its first email, sending mailboxes and sending schedule. |
| Create prospect | Add one prospect, optionally straight into a list. |
| Create prospect list | Create an empty prospect list. |
| Create tag | Create a tag for prospects, campaigns or senders. |
| Delete campaign | Delete a campaign. |
| Delete prospect | Delete a prospect from ManyReach, including every list and campaign. |
| Delete prospect list | Delete a prospect list. |
| Delete tag | Delete a tag. |
| Get account | Get the ManyReach account the key belongs to, with its remaining sending credits. |
| Get campaign | Get one campaign with its settings, tags and sending counts. |
| Get campaign statistics | Get a campaign's emails sent, opens, clicks and replies per day, optionally for a date range. |
| Get prospect | Get one prospect with their details, status and tags. |
| Get prospect list | Get one prospect list. |
| Import prospects | Create or update many prospects by email at once, and add them to a list or a campaign. |
| List blacklisted emails | List blacklisted addresses with the entry id needed to remove one. |
| List campaign prospects | List the prospects enrolled in a campaign with each one's sending status there. |
| List campaigns | List campaigns with their status and counts, optionally only one status. |
| List messages | List replies received or emails sent, filtered by campaign, mailbox or text. |
| List prospect lists | List the account's prospect lists. |
| List prospects | Find prospects by search text, exact email or email validation result. |
| List sending mailboxes | List the mailboxes campaigns send from, optionally only disconnected or blacklisted ones. |
| List tags | List tags, found by name or kind. |
| Remove blacklisted email | Take one address off the blacklist, by its entry id. |
| Tag prospect | Put a tag on a prospect and return all the prospect's tags. |
| Untag prospect | Take a tag off a prospect. |
| Update campaign | Change a campaign's name, first email, mailboxes or sending schedule. |
| Update prospect | Change a prospect's details. |
| Update prospect list | Rename a list or change its description. |
| Update tag | Rename a tag or change its description. |
Blacklist emails
Add email addresses to the blacklist so no campaign emails them.
Inputs
- Email addresses
emailslistRequired - 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
- Name
nametextRequired - The campaign's name, up to 256 characters.
- Description
descriptiontext - A note about the campaign for your team, up to 512 characters.
- From name
from_nametext - The name recipients see the email come from.
- Sending mailboxes
from_emailslist - The mailboxes this campaign sends from.
- First email subject
subjecttext - The subject of the first email. Merge tags like {{FIRSTNAME}} work.
- First email body
bodytext - The HTML body of the first email. Put {{SENDER_SIGNATURE}} where the mailbox's signature should appear.
- Plain text only
text_onlytext - Send without HTML formatting. Leave empty to keep ManyReach's default.One of:
yes,no. - Track opens
track_openstext - Count opens with a tracking pixel. Leave empty to keep the default.One of:
yes,no. - Track clicks
track_clickstext - Count link clicks. Leave empty to keep the default.One of:
yes,no. - Add unsubscribe header
unsubscribe_headertext - Add the List-Unsubscribe header. Leave empty to keep the default.One of:
yes,no. - Stop teammates when someone replies
stop_on_replytext - Stop other teammates' emails to a prospect once they reply.One of:
yes,no. - Daily limit
daily_limitnumber - The most emails the campaign sends a day, 1 to 10000.From 1 to 10000.
- Time zone
time_zonetext - The time zone for the sending hours and start. Needed with a start date.
- Sending days
send_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 from
send_fromtime - Earliest time of day to send, on each chosen day.
- Send until
send_untiltime - Latest time of day to send, on each chosen day.
- Start on
start_datedate - The date the campaign should start when you start it.
- Start at
start_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
- Email
emailtextRequired - The prospect's email address.
- List
list_idnumber - Add the prospect to this list.
- First name
first_nametext - The prospect's first name, for merge tags.
- Last name
last_nametext - The prospect's last name.
- Company
companytext - The company they work for.
- Job title
job_positiontext - Their job title.
- Phone
phonetext - Their phone number.
- Website
websitetext - The company's website.
- Industry
industrytext - The company's industry.
- City
citytext - The city they are in.
- State or province
statetext - The state or province they are in.
- Country
countrytext - The country they are in.
- Location
locationtext - Any other location text, such as an address.
- Company size
company_sizetext - Company size, such as 11-50 (up to 32 characters).
- Company domain
domaintext - The company's domain, such as acme.com.
- Company profile link
company_socialtext - A link to the company's social profile.
- Personal profile link
personal_socialtext - A link to their own social profile, such as LinkedIn.
- Icebreaker
icebreakertext - A personal opening line for emails to them, up to 4000 characters.
- Notes
notestext - Internal notes about the prospect.
- Custom fields
custom_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
- Title
titletextRequired - The list's name, up to 256 characters.
- Description
descriptiontext - 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
- Title
titletextRequired - The tag's name, up to 128 characters.
- Kind
tag_typetext - What the tag is for. Defaults to prospects.One of:
Crm(Prospect tag),Campaign(Campaign tag),Sender(Sender tag). Default:Crm. - Description
descriptiontext - 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
- Campaign
campaign_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 ID
prospect_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
- List
list_idnumberRequired - The prospect list. Pick one, or give its id from an earlier step.
- Remove its prospects first
forcetrue/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
- Tag
tag_idnumberRequired - The tag. Pick one, or give its id from an earlier step.
- Also remove it from everything
forcetrue/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
- Campaign
campaign_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
- Campaign
campaign_idnumberRequired - The campaign. Pick one, or give its id from an earlier step.
- From
date_startdate - First day to include. Defaults to the campaign's start.
- Until
date_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 ID
prospect_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
- List
list_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
- Prospects
prospectslistRequired - 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_idnumber - Add every prospect to this list.
- Add to campaign
campaign_idnumber - Enroll every prospect in this campaign.
- Only add new prospects
add_only_if_newtrue/false - Skip prospects ManyReach already has.Default:
false. - Skip prospects in other campaigns
skip_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
- Search
searchtext - Text to find in the address.
- Page size
limitnumber - How many to return, 1 to 1000. ManyReach's default is 100.From 1 to 1000.
- Page number
pagenumber - Which page to get, starting at 1.At least 1.
- Next page cursor
starting_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
- Campaign
campaign_idnumberRequired - The campaign. Pick one, or give its id from an earlier step.
- Still receiving emails
sending_activetext - Only prospects who are (Yes) or are not (No) still being emailed.One of:
yes,no. - Page size
limitnumber - How many to return, 1 to 1000. ManyReach's default is 100.From 1 to 1000.
- Page number
pagenumber - Which page to get, starting at 1.At least 1.
- Next page cursor
starting_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
- Status
statustext - Only campaigns with this status.One of:
draft,scheduled,preparing,running,paused,completed,archived. - Include archived
include_archivedtrue/false - Also list archived campaigns.Default:
false. - Page size
limitnumber - How many to return, 1 to 1000. ManyReach's default is 100.From 1 to 1000.
- Page number
pagenumber - Which page to get, starting at 1.At least 1.
- Next page cursor
starting_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
- Messages
message_typetextRequired - Which messages to list.One of:
Reply(Replies received),Sent(Campaign emails sent),SentManual(Emails sent by hand). - Campaign
campaign_idnumber - Only messages of this campaign.
- Sending mailbox
sender_idnumber - Only messages sent or received by this mailbox.
- From contains
email_fromtext - Only messages whose sender address contains this text.
- To contains
email_totext - Only messages whose recipient address contains this text.
- Subject contains
subjecttext - Only messages whose subject contains this text.
- Page size
limitnumber - How many to return, 1 to 1000. ManyReach's default is 100.From 1 to 1000.
- Page number
pagenumber - Which page to get, starting at 1.At least 1.
- Next page cursor
starting_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 size
limitnumber - How many to return, 1 to 1000. ManyReach's default is 100.From 1 to 1000.
- Page number
pagenumber - Which page to get, starting at 1.At least 1.
- Next page cursor
starting_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
- Search
searchtext - Text to find in the email, first name or last name.
- Exact email
emailtext - Find the prospect with exactly this email address.
- Email check result
validation_statustext - Only prospects whose email was checked with this result.One of:
Valid,Invalid,CatchAll(Catch-all),Disposable,Unknown,Unvalidated(Not checked yet). - Page size
limitnumber - How many to return, 1 to 1000. ManyReach's default is 100.From 1 to 1000.
- Page number
pagenumber - Which page to get, starting at 1.At least 1.
- Next page cursor
starting_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
- Search
searchtext - Text to find in the mailbox address or name.
- Problem
statustext - Only mailboxes that are disconnected or on a blacklist.One of:
error(Disconnected),blacklisted(On a blacklist). - Warming up
warmuptext - Only mailboxes with warmup on (Yes) or off (No).One of:
yes,no. - Page size
limitnumber - How many to return, 1 to 1000. ManyReach's default is 100.From 1 to 1000.
- Page number
pagenumber - Which page to get, starting at 1.At least 1.
- Next page cursor
starting_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
- Search
searchtext - Text to find in the tag's name.
- Kind
tag_typetext - Only tags for prospects, campaigns or senders.One of:
Crm(Prospect tag),Campaign(Campaign tag),Sender(Sender tag). - Include prospect counts
include_prospect_counttrue/false - Add how many prospects have each tag.Default:
false. - Page size
limitnumber - How many to return, 1 to 1000. ManyReach's default is 100.From 1 to 1000.
- Page number
pagenumber - Which page to get, starting at 1.At least 1.
- Next page cursor
starting_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 ID
block_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 ID
prospect_idnumberRequired - The prospect's id, from 'List prospects' or an earlier step.
- Tag
tag_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 ID
prospect_idnumberRequired - The prospect's id, from 'List prospects' or an earlier step.
- Tag
tag_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
- Campaign
campaign_idnumberRequired - The campaign. Pick one, or give its id from an earlier step.
- Name
nametext - A new name. Leave empty to keep it.
- Description
descriptiontext - A note about the campaign for your team, up to 512 characters.
- From name
from_nametext - The name recipients see the email come from.
- Sending mailboxes
from_emailslist - The mailboxes this campaign sends from.
- First email subject
subjecttext - The subject of the first email. Merge tags like {{FIRSTNAME}} work.
- First email body
bodytext - The HTML body of the first email. Put {{SENDER_SIGNATURE}} where the mailbox's signature should appear.
- Plain text only
text_onlytext - Send without HTML formatting. Leave empty to keep ManyReach's default.One of:
yes,no. - Track opens
track_openstext - Count opens with a tracking pixel. Leave empty to keep the default.One of:
yes,no. - Track clicks
track_clickstext - Count link clicks. Leave empty to keep the default.One of:
yes,no. - Add unsubscribe header
unsubscribe_headertext - Add the List-Unsubscribe header. Leave empty to keep the default.One of:
yes,no. - Stop teammates when someone replies
stop_on_replytext - Stop other teammates' emails to a prospect once they reply.One of:
yes,no. - Daily limit
daily_limitnumber - The most emails the campaign sends a day, 1 to 10000.From 1 to 10000.
- Time zone
time_zonetext - The time zone for the sending hours and start. Needed with a start date.
- Sending days
send_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 from
send_fromtime - Earliest time of day to send, on each chosen day.
- Send until
send_untiltime - Latest time of day to send, on each chosen day.
- Start on
start_datedate - The date the campaign should start when you start it.
- Start at
start_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 ID
prospect_idnumberRequired - The prospect's id, from 'List prospects' or an earlier step.
- Receives emails
sending_activetext - Yes to email them from campaigns, No to stop. Leave empty to keep it.One of:
yes,no. - First name
first_nametext - The prospect's first name, for merge tags.
- Last name
last_nametext - The prospect's last name.
- Company
companytext - The company they work for.
- Job title
job_positiontext - Their job title.
- Phone
phonetext - Their phone number.
- Website
websitetext - The company's website.
- Industry
industrytext - The company's industry.
- City
citytext - The city they are in.
- State or province
statetext - The state or province they are in.
- Country
countrytext - The country they are in.
- Location
locationtext - Any other location text, such as an address.
- Company size
company_sizetext - Company size, such as 11-50 (up to 32 characters).
- Company domain
domaintext - The company's domain, such as acme.com.
- Company profile link
company_socialtext - A link to the company's social profile.
- Personal profile link
personal_socialtext - A link to their own social profile, such as LinkedIn.
- Icebreaker
icebreakertext - A personal opening line for emails to them, up to 4000 characters.
- Notes
notestext - Internal notes about the prospect.
- Custom fields
custom_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
- List
list_idnumberRequired - The prospect list. Pick one, or give its id from an earlier step.
- Title
titletext - A new title. Leave empty to keep it.
- Description
descriptiontext - 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
- Tag
tag_idnumberRequired - The tag. Pick one, or give its id from an earlier step.
- Title
titletext - A new title. Leave empty to keep it.
- Description
descriptiontext - 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"
}
}