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

ActionWhat it does
Add prospect to listAdd a prospect to a list by email or LinkedIn profile.
Add to Do-not-email listAdd emails, domains or LinkedIn profiles to a Do-not-email list, so no campaign contacts them.
Change recipient statusSet a campaign recipient to Active, Paused or Unsubscribed.
Check recipient statusCheck 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 listCreate a Do-not-email list.
Create prospect listCreate a new, empty prospect list.
Delete Do-not-email listDelete one of your Do-not-email lists.
Find email by name and domainFind 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 emailFind the prospects in your lists with an email address, with their lists and campaigns.
Get campaign activityGet 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 progressGet a campaign's status, how far through it is, and how many recipients haven't finished it.
Get credit balanceGet the account's credit balance, unique recipients used this month and the days until the limit resets.
Get profile from emailLook up the person behind an email address in Snov.io's database: name, location, social profiles and jobs.
Get prospectGet a prospect by ID: their details, jobs, the lists they're in and the campaigns they're a recipient of.
List campaignsList your campaigns (and your team's, if you can see them) with their status and prospect list.
List Do-not-email entriesGet the emails, domains and LinkedIn profiles in a Do-not-email list, oldest first.
List Do-not-email listsList your Do-not-email lists (addresses, domains and LinkedIn profiles campaigns never contact), with how many entries each has.
List prospect listsList your prospect lists (and your team's, if you can see them), with how many prospects each holds.
List prospects in listGet the prospects in a list with their emails, newest first.
Remove from Do-not-email listRemove emails, domains or LinkedIn profiles from a Do-not-email list.
Update prospectChange a prospect's details, found by email in a list.
Verify emailsCheck 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 listlist_idtextRequired
The prospect list. Pick one, or give its ID from an earlier step.
Emailemailtext
The prospect's email address. Needed unless a LinkedIn profile is given.
First namefirst_nametext
The prospect's first name.
Last namelast_nametext
The prospect's last name.
Full namefull_nametext
The prospect's full name.
Job titlepositiontext
The prospect's job title.
Companycompany_nametext
The name of the prospect's company.
Company websitecompany_sitetext
The company's website, such as https://example.com.
Countrycountrytext
The prospect's country, written as Snov.io lists it (United States).
Localitylocalitytext
The prospect's city or region.
LinkedIn profilelinkedin_urltext
The prospect's LinkedIn profile URL.
Custom fieldscustom_fieldsobject
Values for custom fields you've made in Snov.io, by field name, for example {"Specialization": "Sales"}.
Phone numbersphoneslist
The prospect's phone numbers.
If they're already a prospectif_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 listlist_idtextRequired
The Do-not-email list. Pick one, or give its ID from an earlier step.
Emails, domains or LinkedIn URLsitemslistRequired
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

Campaigncampaign_idtextRequired
The campaign. Pick one, or give its ID from an earlier step.
Recipient emailemailtextRequired
The recipient's email address.
StatusstatustextRequired
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

Campaigncampaign_idtextRequired
The campaign. Pick one, or give its ID from an earlier step.
EmailsemailslistRequired
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

NamenametextRequired
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

NamenametextRequired
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 listlist_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 namefirst_nametextRequired
The person's first name.
Last namelast_nametextRequired
The person's last name.
Company domaindomaintextRequired
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

EmailemailtextRequired
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

Campaigncampaign_idtextRequired
The campaign. Pick one, or give its ID from an earlier step.
Fromdate_fromdateRequired
The first day to include (UTC).
Todate_todateRequired
The last day to include (UTC), at most 31 days later.
Eventsevent_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).
Skipoffsetnumber
How many events to skip, for the next page.At least 0.
Page sizelimitnumber
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

Campaigncampaign_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

EmailemailtextRequired
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 IDprospect_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 listlist_idtextRequired
The Do-not-email list. Pick one, or give its ID from an earlier step.
Pagepagenumber
Which page to get, starting at 1.At least 1.
Page sizeper_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 listsinclude_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 listlist_idtextRequired
The prospect list. Pick one, or give its ID from an earlier step.
Pagepagenumber
Which page to get, starting at 1.At least 1.
Page sizeper_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 listlist_idtextRequired
The Do-not-email list. Pick one, or give its ID from an earlier step.
Emails, domains or LinkedIn URLsitemslistRequired
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 listlist_idtextRequired
The prospect list. Pick one, or give its ID from an earlier step.
EmailemailtextRequired
The email of the prospect to change.
First namefirst_nametext
The prospect's first name.
Last namelast_nametext
The prospect's last name.
Full namefull_nametext
The prospect's full name.
Job titlepositiontext
The prospect's job title.
Companycompany_nametext
The name of the prospect's company.
Company websitecompany_sitetext
The company's website, such as https://example.com.
Countrycountrytext
The prospect's country, written as Snov.io lists it (United States).
Localitylocalitytext
The prospect's city or region.
LinkedIn profilelinkedin_urltext
The prospect's LinkedIn profile URL.
Custom fieldscustom_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

EmailsemailslistRequired
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
}

On this page