Snov.io
App · 22 actions
Find and verify emails, keep prospect lists and Do-not-email lists, check and change campaign recipients, and start workflows when campaign emails are sent, opened, clicked, bounced or answered.
Actions
| Action | What it does |
|---|---|
| Add prospect to list | Add a prospect to a list by email or LinkedIn profile. |
| Add to Do-not-email list | Add emails, domains or LinkedIn profiles to a Do-not-email list, so no campaign contacts them. |
| Change recipient status | Set a campaign recipient to Active, Paused or Unsubscribed. |
| Check recipient status | Check whether up to 100 email addresses are recipients of a campaign, and the status of each (such as active, finished or unsubscribed). |
| Create Do-not-email list | Create a Do-not-email list. |
| Create prospect list | Create a new, empty prospect list. |
| Delete Do-not-email list | Delete one of your Do-not-email lists. |
| Find email by name and domain | Find a person's work email from their first and last name and their company's domain, with whether Snov.io could verify it. |
| Find prospects by email | Find the prospects in your lists with an email address, with their lists and campaigns. |
| Get campaign activity | Get what happened in a campaign between two dates (at most 31 days apart): each email sent, open, click, reply, bounce and unsubscribe, with the recipient's details. |
| Get campaign progress | Get a campaign's status, how far through it is, and how many recipients haven't finished it. |
| Get credit balance | Get the account's credit balance, unique recipients used this month and the days until the limit resets. |
| Get profile from email | Look up the person behind an email address in Snov.io's database: name, location, social profiles and jobs. |
| Get prospect | Get a prospect by ID: their details, jobs, the lists they're in and the campaigns they're a recipient of. |
| List campaigns | List your campaigns (and your team's, if you can see them) with their status and prospect list. |
| List Do-not-email entries | Get the emails, domains and LinkedIn profiles in a Do-not-email list, oldest first. |
| List Do-not-email lists | List your Do-not-email lists (addresses, domains and LinkedIn profiles campaigns never contact), with how many entries each has. |
| List prospect lists | List your prospect lists (and your team's, if you can see them), with how many prospects each holds. |
| List prospects in list | Get the prospects in a list with their emails, newest first. |
| Remove from Do-not-email list | Remove emails, domains or LinkedIn profiles from a Do-not-email list. |
| Update prospect | Change a prospect's details, found by email in a list. |
| Verify emails | Check up to 10 email addresses: whether each is valid, not valid or unverifiable (and why), disposable, webmail or gibberish. |
Add prospect to list
Add a prospect to a list by email or LinkedIn profile. If a campaign runs on that list, it starts for them.
Inputs
- Prospect list
list_idtextRequired - The prospect list. Pick one, or give its ID from an earlier step.
- Email
emailtext - The prospect's email address. Needed unless a LinkedIn profile is given.
- First name
first_nametext - The prospect's first name.
- Last name
last_nametext - The prospect's last name.
- Full name
full_nametext - The prospect's full name.
- Job title
positiontext - The prospect's job title.
- Company
company_nametext - The name of the prospect's company.
- Company website
company_sitetext - The company's website, such as https://example.com.
- Country
countrytext - The prospect's country, written as Snov.io lists it (United States).
- Locality
localitytext - The prospect's city or region.
- LinkedIn profile
linkedin_urltext - The prospect's LinkedIn profile URL.
- Custom fields
custom_fieldsobject - Values for custom fields you've made in Snov.io, by field name, for example {"Specialization": "Sales"}.
- Phone numbers
phoneslist - The prospect's phone numbers.
- If they're already a prospect
if_existstext - What to do when a prospect with this email is already in one of your lists.One of:
skip(Leave the existing prospect as it is (default)),update(Update the existing prospect),duplicate(Add a duplicate prospect). Default:skip.
Outputs
addedtrue/false- True if the prospect was added to the list
prospect_idtext- The prospect's ID
updatedtrue/false- True if an existing prospect was updated
Example output
{
"added": true,
"prospect_id": "0Y2QzowWL1rHpIptwaRp0Q==",
"updated": false
}Add to Do-not-email list
Add emails, domains or LinkedIn profiles to a Do-not-email list, so no campaign contacts them. Invalid entries are listed with the reason; the rest are still added.
Inputs
- Do-not-email list
list_idtextRequired - The Do-not-email list. Pick one, or give its ID from an earlier step.
- Emails, domains or LinkedIn URLs
itemslistRequired - Up to 100 email addresses, domains (example.com) or LinkedIn profile URLs (linkedin.com/in/...).
Outputs
addedlist- Entries added
added_countnumber- How many were added
duplicateslist- Entries already there
rejectedlist- Items not taken, with the reason
rejected_countnumber- How many were refused
Example output
{
"added": [
"jo@example.com"
],
"added_count": 1,
"duplicates": [
"example.com"
],
"rejected": [
{
"item": "jo@example",
"reason": "Invalid email address"
}
],
"rejected_count": 1
}Change recipient status
Set a campaign recipient to Active, Paused or Unsubscribed. A recipient who has finished or been moved can't be changed.
Inputs
- Campaign
campaign_idtextRequired - The campaign. Pick one, or give its ID from an earlier step.
- Recipient email
emailtextRequired - The recipient's email address.
- Status
statustextRequired - The status to set.One of:
Active,Paused,Unsubscribed.
Outputs
campaign_idnumber- The campaign
changedtrue/false- Always true once changed
emailtext- The recipient
statustext- The status set
Example output
{
"campaign_id": 237945,
"changed": true,
"email": "jo@example.com",
"status": "Paused"
}Check recipient status
Check whether up to 100 email addresses are recipients of a campaign, and the status of each (such as active, finished or unsubscribed). Use it before adding someone, so nobody is contacted twice.
Inputs
- Campaign
campaign_idtextRequired - The campaign. Pick one, or give its ID from an earlier step.
- Emails
emailslistRequired - Up to 100 email addresses to check.
Outputs
countnumber- How many
in_campaign_countnumber- How many are in the campaign
recipientslist- One per address
Example output
{
"count": 1,
"in_campaign_count": 1,
"recipients": [
{
"email": "jo@example.com",
"exist": true,
"status": "active"
}
]
}Create Do-not-email list
Create a Do-not-email list. Its name must be unique, and an account can have up to 200.
Inputs
- Name
nametextRequired - The list's name, up to 100 characters.
Outputs
list_idnumber- The new list's ID
nametext- Its name, as Snov.io saved it
Example output
{
"list_id": 9,
"name": "Opted out"
}Create prospect list
Create a new, empty prospect list.
Inputs
- Name
nametextRequired - The list's name, up to 100 characters.
Outputs
list_idnumber- The new list's ID
nametext- Its name
Example output
{
"list_id": 1234567,
"name": "Webinar sign-ups"
}Delete Do-not-email list
Delete one of your Do-not-email lists. Campaigns that used it no longer check against it. Your last list can't be deleted.
Inputs
- Do-not-email list
list_idtextRequired - The Do-not-email list. Pick one, or give its ID from an earlier step.
Outputs
deletedtrue/false- Always true once deleted
list_idnumber- The list deleted
Example output
{
"deleted": true,
"list_id": 9
}Find email by name and domain
Find a person's work email from their first and last name and their company's domain, with whether Snov.io could verify it. Uses 1 Snov.io credit for each email found that is valid or unverifiable; nothing when none is found.
Inputs
- First name
first_nametextRequired - The person's first name.
- Last name
last_nametextRequired - The person's last name.
- Company domain
domaintextRequired - The domain of the company they work for, such as acme.com.
Outputs
countnumber- How many
emailtext- The best email found: a valid one if any
emailslist- Every email found
foundtrue/false- True if Snov.io found an email
smtp_statustext- That email's status: valid or unknown (unverifiable)
task_hashtext- Snov.io's ID for the search
Example output
{
"count": 1,
"email": "jo.bloggs@acme.com",
"emails": [
{
"email": "jo.bloggs@acme.com",
"is_disposable": false,
"is_gibberish": false,
"is_valid_format": true,
"is_webmail": false,
"smtp_status": "valid",
"unknown_status_reason": ""
}
],
"found": true,
"smtp_status": "valid",
"task_hash": "af50fb238757ad092ad6e57e130b0dea"
}Find prospects by email
Find the prospects in your lists with an email address, with their lists and campaigns. Free.
Inputs
- Email
emailtextRequired - The email address to find.
Outputs
countnumber- How many
prospectslist- The prospects found
Example output
{
"count": 1,
"prospects": [
{
"campaigns": [],
"country": "United States",
"currentJob": [
{
"companyName": "Octagon",
"country": "United States",
"endDate": "",
"industry": "Entertainment",
"locality": "United States",
"position": "Senior Brand Director",
"site": "http://octagon.com",
"size": "1-10",
"socialLink": "https://www.linkedin.com/company/659312",
"startDate": "2018-07-31"
}
],
"firstName": "Gavin",
"id": "xusD3-T_K5IktGoaa8Jc8A==",
"industry": "Entertainment",
"lastName": "Vanrooyen",
"lastUpdateDate": {
"date": "2026-09-11 12:37:58.000000",
"timezone": "UTC",
"timezone_type": 3
},
"lists": [
{
"id": 1250344,
"name": "People List"
}
],
"locality": "Greater Atlanta Area",
"name": "Gavin Vanrooyen",
"previousJob": [],
"social": [
{
"link": "https://www.linkedin.com/in/gavin-vanrooyen/",
"type": "linkedIn"
}
]
}
]
}Get campaign activity
Get what happened in a campaign between two dates (at most 31 days apart): each email sent, open, click, reply, bounce and unsubscribe, with the recipient's details. Gets one page.
Inputs
- Campaign
campaign_idtextRequired - The campaign. Pick one, or give its ID from an earlier step.
- From
date_fromdateRequired - The first day to include (UTC).
- To
date_todateRequired - The last day to include (UTC), at most 31 days later.
- Events
event_typeslist - Only these kinds of event. Leave empty for all.One or more of:
sent,open(Opened),click(Clicked),reply(Replied),bounce(Bounced),unsubscribe(Unsubscribed). - Skip
offsetnumber - How many events to skip, for the next page.At least 0.
- Page size
limitnumber - How many events to get, 1 to 1,000. Defaults to 100.From 1 to 1000.
Outputs
countnumber- How many
eventslist- The events
has_moretrue/false- True if there is another page
next_offsetnumber- The Skip value for the next page
totalnumber- Events in the range, of every kind
Example output
{
"count": 1,
"events": [
{
"company": "Acme",
"country": "United States",
"email_subject": "About our plans",
"event_time": "2026-11-15 10:58:52",
"event_type": "sent",
"hq_phone": "15555550100",
"industry": "Information Technology & Services",
"job_position": "Head of Sales",
"location": "Austin",
"phone": "15555550100",
"recipient_email": "jo@example.com",
"recipient_name": "Jo Bloggs",
"sender_email": "sender@example.com",
"website": "example.com"
}
],
"has_more": false,
"next_offset": 0,
"total": 1
}Get campaign progress
Get a campaign's status, how far through it is, and how many recipients haven't finished it.
Inputs
- Campaign
campaign_idtextRequired - The campaign. Pick one, or give its ID from an earlier step.
Outputs
campaign_idnumber- The campaign
progresstext- How far through it is, such as 90%
statustext- The campaign's status, such as Active
unfinishednumber- Recipients who haven't finished it
Example output
{
"campaign_id": 237945,
"progress": "90%",
"status": "Active",
"unfinished": 1
}Get credit balance
Get the account's credit balance, unique recipients used this month and the days until the limit resets. Free.
Inputs
None.
Outputs
balancenumber- Credits left
expires_innumber- Days until the subscription ends
limit_resets_innumber- Days until the limit resets
teamworktrue/false- True if you're part of a team
unique_recipients_usednumber- Unique recipients used this month
Example output
{
"balance": 25000.0,
"expires_in": 359,
"limit_resets_in": 29,
"teamwork": false,
"unique_recipients_used": 0
}Get profile from email
Look up the person behind an email address in Snov.io's database: name, location, social profiles and jobs. Uses 1 Snov.io credit, or none if nothing is found.
Inputs
- Email
emailtextRequired - The email address to look up.
Outputs
emailtext- The email looked up
foundtrue/false- True if Snov.io had a profile
profileobject- The profile, empty if none
Example output
{
"email": "lizi@example.com",
"found": true,
"profile": {
"country": "Singapore",
"currentJobs": [
{
"companyName": "Octagon",
"country": "United States",
"endDate": "",
"industry": "Entertainment",
"locality": "United States",
"position": "Senior Brand Director",
"site": "http://octagon.com",
"size": "1-10",
"socialLink": "https://www.linkedin.com/company/659312",
"startDate": "2018-07-31"
}
],
"firstName": "Lizi",
"id": 301592,
"industry": "Marketing and Advertising",
"lastName": "Hamer",
"lastUpdateDate": "2026-02-07 10:12:28",
"locality": "Singapore",
"logo": "https://app.snov.io/img/peoples/010fcf23.jpg",
"name": "Lizi Hamer",
"previousJobs": [],
"social": [
{
"link": "https://www.linkedin.com/in/lizihamer/",
"type": "linkedIn"
}
],
"source": "linkedIn"
}
}Get prospect
Get a prospect by ID: their details, jobs, the lists they're in and the campaigns they're a recipient of.
Inputs
- Prospect ID
prospect_idtextRequired - The prospect's ID, from 'Add prospect to list' or 'Find prospects by email'.
Outputs
prospectobject- The prospect
Example output
{
"prospect": {
"campaigns": [],
"country": "United States",
"currentJob": [
{
"companyName": "Octagon",
"country": "United States",
"endDate": "",
"industry": "Entertainment",
"locality": "United States",
"position": "Senior Brand Director",
"site": "http://octagon.com",
"size": "1-10",
"socialLink": "https://www.linkedin.com/company/659312",
"startDate": "2018-07-31"
}
],
"firstName": "Gavin",
"id": "xusD3-T_K5IktGoaa8Jc8A==",
"industry": "Entertainment",
"lastName": "Vanrooyen",
"lastUpdateDate": {
"date": "2026-09-11 12:37:58.000000",
"timezone": "UTC",
"timezone_type": 3
},
"lists": [
{
"id": 1250344,
"name": "People List"
}
],
"locality": "Greater Atlanta Area",
"name": "Gavin Vanrooyen",
"previousJob": [],
"social": [
{
"link": "https://www.linkedin.com/in/gavin-vanrooyen/",
"type": "linkedIn"
}
]
}
}List campaigns
List your campaigns (and your team's, if you can see them) with their status and prospect list.
Inputs
None.
Outputs
campaignslist- The campaigns
countnumber- How many
Example output
{
"campaigns": [
{
"campaign": "New Campaign",
"created_at": 1789469976,
"hash": "e272be8f9a6894f5b5894fe2ef77095e",
"id": 237945,
"list_id": 8512947,
"started_at": 1789470021,
"status": "Paused",
"updated_at": 1789470026
}
],
"count": 1
}List Do-not-email entries
Get the emails, domains and LinkedIn profiles in a Do-not-email list, oldest first. Gets one page.
Inputs
- Do-not-email list
list_idtextRequired - The Do-not-email list. Pick one, or give its ID from an earlier step.
- Page
pagenumber - Which page to get, starting at 1.At least 1.
- Page size
per_pagenumber - How many to get, 1 to 5,000. Defaults to 100.From 1 to 5000.
Outputs
countnumber- How many
has_moretrue/false- True if there may be another page
itemslist- The entries
pagenumber- The page returned
per_pagenumber- The page size used
totalnumber- Entries in the whole list
Example output
{
"count": 1,
"has_more": false,
"items": [
{
"type": "email",
"value": "jo@example.com"
}
],
"page": 1,
"per_page": 100,
"total": 1
}List Do-not-email lists
List your Do-not-email lists (addresses, domains and LinkedIn profiles campaigns never contact), with how many entries each has.
Inputs
None.
Outputs
countnumber- How many
listslist- The lists
Example output
{
"count": 1,
"lists": [
{
"id": 8,
"name": "Do-not-email List",
"owner": "Jo Bloggs",
"total": 100
}
]
}List prospect lists
List your prospect lists (and your team's, if you can see them), with how many prospects each holds.
Inputs
- Include deleted lists
include_deletedtrue/false - Also list lists that were deleted. Off by default.
Outputs
countnumber- How many
listslist- The lists
Example output
{
"count": 1,
"lists": [
{
"contacts": 1,
"creationDate": {
"date": "2026-04-07 08:25:44.000000",
"timezone": "UTC",
"timezone_type": 3
},
"deletionDate": {
"date": "",
"timezone": "UTC",
"timezone_type": 3
},
"id": 1818597,
"isDeleted": false,
"name": "FirstSend"
}
]
}List prospects in list
Get the prospects in a list with their emails, newest first. Gets one page; to see more, run it again with the next page.
Inputs
- Prospect list
list_idtextRequired - The prospect list. Pick one, or give its ID from an earlier step.
- Page
pagenumber - Which page to get, starting at 1.At least 1.
- Page size
per_pagenumber - How many to get, 1 to 5,000. Defaults to 100.From 1 to 5000.
Outputs
countnumber- How many
has_moretrue/false- True if there may be another page
listobject- The list
pagenumber- The page returned
per_pagenumber- The page size used
prospectslist- The prospects
Example output
{
"count": 1,
"has_more": false,
"list": {
"contacts": 1,
"creationDate": {
"date": "2026-05-19 17:34:39.000000",
"timezone": "UTC",
"timezone_type": 3
},
"name": "Lead list"
},
"page": 1,
"per_page": 100,
"prospects": [
{
"emails": [
{
"domainType": "linkedin_email",
"email": "john@example.com",
"isDisposable": false,
"isGibberish": false,
"isValidFormat": true,
"isVerified": true,
"isWebmail": false,
"jobStatus": "any",
"probability": 99,
"smtpStatus": 3
}
],
"firstName": "John",
"id": "226db935fc93422496fda5d5209e8cbf",
"lastName": "Doe",
"name": "John Doe"
}
]
}Remove from Do-not-email list
Remove emails, domains or LinkedIn profiles from a Do-not-email list. Recipients already blocked by them stay blocked.
Inputs
- Do-not-email list
list_idtextRequired - The Do-not-email list. Pick one, or give its ID from an earlier step.
- Emails, domains or LinkedIn URLs
itemslistRequired - Up to 100 email addresses, domains (example.com) or LinkedIn profile URLs (linkedin.com/in/...).
Outputs
deletedlist- Entries removed
deleted_countnumber- How many were removed
not_foundlist- Entries not in the list
rejectedlist- Items not taken, with the reason
Example output
{
"deleted": [
"jo@example.com"
],
"deleted_count": 1,
"not_found": [],
"rejected": []
}Update prospect
Change a prospect's details, found by email in a list. Only the fields given change; the rest are kept.
Inputs
- Prospect list
list_idtextRequired - The prospect list. Pick one, or give its ID from an earlier step.
- Email
emailtextRequired - The email of the prospect to change.
- First name
first_nametext - The prospect's first name.
- Last name
last_nametext - The prospect's last name.
- Full name
full_nametext - The prospect's full name.
- Job title
positiontext - The prospect's job title.
- Company
company_nametext - The name of the prospect's company.
- Company website
company_sitetext - The company's website, such as https://example.com.
- Country
countrytext - The prospect's country, written as Snov.io lists it (United States).
- Locality
localitytext - The prospect's city or region.
- LinkedIn profile
linkedin_urltext - The prospect's LinkedIn profile URL.
- Custom fields
custom_fieldsobject - Values for custom fields you've made in Snov.io, by field name, for example {"Specialization": "Sales"}.
Outputs
addedtrue/false- True if the prospect was added to the list
emailtext- The prospect's email
prospectobject- The details sent to Snov.io
prospect_idtext- The prospect's ID
updatedtrue/false- True if an existing prospect was updated
Example output
{
"added": false,
"email": "jo@example.com",
"prospect": {
"company_name": "Acme",
"company_site": "https://acme.com",
"country": "United States",
"first_name": "Jo",
"full_name": "Jo Bloggs",
"last_name": "Bloggs",
"linkedin_url": "",
"locality": "Austin",
"position": "Head of Sales"
},
"prospect_id": "0Y2QzowWL1rHpIptwaRp0Q==",
"updated": true
}Verify emails
Check up to 10 email addresses: whether each is valid, not valid or unverifiable (and why), disposable, webmail or gibberish. Uses Snov.io credits for each address checked.
Inputs
- Emails
emailslistRequired - Up to 10 email addresses to check.
Outputs
countnumber- How many
resultslist- One per address
task_hashtext- Snov.io's ID for the check
valid_countnumber- How many are valid
Example output
{
"count": 1,
"results": [
{
"email": "jo@example.com",
"is_disposable": false,
"is_gibberish": false,
"is_valid_format": true,
"is_webmail": false,
"smtp_status": "valid",
"unknown_status_reason": ""
}
],
"task_hash": "0110437df6811068197577a538849a4b",
"valid_count": 1
}