# Snov.io

> 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.

App · 22 actions. Web page: https://docs.lodol.com/docs/integrations/snov-io

## Actions

### 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_id`, text, required): The prospect list. Pick one, or give its ID from an earlier step.
- Email (`email`, text): The prospect's email address. Needed unless a LinkedIn profile is given.
- First name (`first_name`, text): The prospect's first name.
- Last name (`last_name`, text): The prospect's last name.
- Full name (`full_name`, text): The prospect's full name.
- Job title (`position`, text): The prospect's job title.
- Company (`company_name`, text): The name of the prospect's company.
- Company website (`company_site`, text): The company's website, such as https://example.com.
- Country (`country`, text): The prospect's country, written as Snov.io lists it (United States).
- Locality (`locality`, text): The prospect's city or region.
- LinkedIn profile (`linkedin_url`, text): The prospect's LinkedIn profile URL.
- Custom fields (`custom_fields`, object): Values for custom fields you've made in Snov.io, by field name, for example {"Specialization": "Sales"}.
- Phone numbers (`phones`, list): The prospect's phone numbers.
- If they're already a prospect (`if_exists`, text): 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**

- `added` (true/false): True if the prospect was added to the list
- `prospect_id` (text): The prospect's ID
- `updated` (true/false): True if an existing prospect was updated

**Example output**

```json
{
  "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_id`, text, required): The Do-not-email list. Pick one, or give its ID from an earlier step.
- Emails, domains or LinkedIn URLs (`items`, list, required): Up to 100 email addresses, domains (example.com) or LinkedIn profile URLs (linkedin.com/in/...).

**Outputs**

- `added` (list): Entries added
- `added_count` (number): How many were added
- `duplicates` (list): Entries already there
- `rejected` (list): Items not taken, with the reason
- `rejected_count` (number): How many were refused

**Example output**

```json
{
  "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_id`, text, required): The campaign. Pick one, or give its ID from an earlier step.
- Recipient email (`email`, text, required): The recipient's email address.
- Status (`status`, text, required): The status to set. One of: `Active`, `Paused`, `Unsubscribed`.

**Outputs**

- `campaign_id` (number): The campaign
- `changed` (true/false): Always true once changed
- `email` (text): The recipient
- `status` (text): The status set

**Example output**

```json
{
  "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_id`, text, required): The campaign. Pick one, or give its ID from an earlier step.
- Emails (`emails`, list, required): Up to 100 email addresses to check.

**Outputs**

- `count` (number): How many
- `in_campaign_count` (number): How many are in the campaign
- `recipients` (list): One per address

**Example output**

```json
{
  "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 (`name`, text, required): The list's name, up to 100 characters.

**Outputs**

- `list_id` (number): The new list's ID
- `name` (text): Its name, as Snov.io saved it

**Example output**

```json
{
  "list_id": 9,
  "name": "Opted out"
}
```

### Create prospect list

Create a new, empty prospect list.

**Inputs**

- Name (`name`, text, required): The list's name, up to 100 characters.

**Outputs**

- `list_id` (number): The new list's ID
- `name` (text): Its name

**Example output**

```json
{
  "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_id`, text, required): The Do-not-email list. Pick one, or give its ID from an earlier step.

**Outputs**

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

**Example output**

```json
{
  "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_name`, text, required): The person's first name.
- Last name (`last_name`, text, required): The person's last name.
- Company domain (`domain`, text, required): The domain of the company they work for, such as acme.com.

**Outputs**

- `count` (number): How many
- `email` (text): The best email found: a valid one if any
- `emails` (list): Every email found
- `found` (true/false): True if Snov.io found an email
- `smtp_status` (text): That email's status: valid or unknown (unverifiable)
- `task_hash` (text): Snov.io's ID for the search

**Example output**

```json
{
  "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 (`email`, text, required): The email address to find.

**Outputs**

- `count` (number): How many
- `prospects` (list): The prospects found

**Example output**

```json
{
  "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_id`, text, required): The campaign. Pick one, or give its ID from an earlier step.
- From (`date_from`, date, required): The first day to include (UTC).
- To (`date_to`, date, required): The last day to include (UTC), at most 31 days later.
- Events (`event_types`, list): 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 (`offset`, number): How many events to skip, for the next page. At least 0.
- Page size (`limit`, number): How many events to get, 1 to 1,000. Defaults to 100. From 1 to 1000.

**Outputs**

- `count` (number): How many
- `events` (list): The events
- `has_more` (true/false): True if there is another page
- `next_offset` (number): The Skip value for the next page
- `total` (number): Events in the range, of every kind

**Example output**

```json
{
  "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_id`, text, required): The campaign. Pick one, or give its ID from an earlier step.

**Outputs**

- `campaign_id` (number): The campaign
- `progress` (text): How far through it is, such as 90%
- `status` (text): The campaign's status, such as Active
- `unfinished` (number): Recipients who haven't finished it

**Example output**

```json
{
  "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**

- `balance` (number): Credits left
- `expires_in` (number): Days until the subscription ends
- `limit_resets_in` (number): Days until the limit resets
- `teamwork` (true/false): True if you're part of a team
- `unique_recipients_used` (number): Unique recipients used this month

**Example output**

```json
{
  "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 (`email`, text, required): The email address to look up.

**Outputs**

- `email` (text): The email looked up
- `found` (true/false): True if Snov.io had a profile
- `profile` (object): The profile, empty if none

**Example output**

```json
{
  "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_id`, text, required): The prospect's ID, from 'Add prospect to list' or 'Find prospects by email'.

**Outputs**

- `prospect` (object): The prospect

**Example output**

```json
{
  "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**

- `campaigns` (list): The campaigns
- `count` (number): How many

**Example output**

```json
{
  "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_id`, text, required): The Do-not-email list. Pick one, or give its ID from an earlier step.
- Page (`page`, number): Which page to get, starting at 1. At least 1.
- Page size (`per_page`, number): How many to get, 1 to 5,000. Defaults to 100. From 1 to 5000.

**Outputs**

- `count` (number): How many
- `has_more` (true/false): True if there may be another page
- `items` (list): The entries
- `page` (number): The page returned
- `per_page` (number): The page size used
- `total` (number): Entries in the whole list

**Example output**

```json
{
  "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**

- `count` (number): How many
- `lists` (list): The lists

**Example output**

```json
{
  "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_deleted`, true/false): Also list lists that were deleted. Off by default.

**Outputs**

- `count` (number): How many
- `lists` (list): The lists

**Example output**

```json
{
  "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_id`, text, required): The prospect list. Pick one, or give its ID from an earlier step.
- Page (`page`, number): Which page to get, starting at 1. At least 1.
- Page size (`per_page`, number): How many to get, 1 to 5,000. Defaults to 100. From 1 to 5000.

**Outputs**

- `count` (number): How many
- `has_more` (true/false): True if there may be another page
- `list` (object): The list
- `page` (number): The page returned
- `per_page` (number): The page size used
- `prospects` (list): The prospects

**Example output**

```json
{
  "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_id`, text, required): The Do-not-email list. Pick one, or give its ID from an earlier step.
- Emails, domains or LinkedIn URLs (`items`, list, required): Up to 100 email addresses, domains (example.com) or LinkedIn profile URLs (linkedin.com/in/...).

**Outputs**

- `deleted` (list): Entries removed
- `deleted_count` (number): How many were removed
- `not_found` (list): Entries not in the list
- `rejected` (list): Items not taken, with the reason

**Example output**

```json
{
  "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_id`, text, required): The prospect list. Pick one, or give its ID from an earlier step.
- Email (`email`, text, required): The email of the prospect to change.
- First name (`first_name`, text): The prospect's first name.
- Last name (`last_name`, text): The prospect's last name.
- Full name (`full_name`, text): The prospect's full name.
- Job title (`position`, text): The prospect's job title.
- Company (`company_name`, text): The name of the prospect's company.
- Company website (`company_site`, text): The company's website, such as https://example.com.
- Country (`country`, text): The prospect's country, written as Snov.io lists it (United States).
- Locality (`locality`, text): The prospect's city or region.
- LinkedIn profile (`linkedin_url`, text): The prospect's LinkedIn profile URL.
- Custom fields (`custom_fields`, object): Values for custom fields you've made in Snov.io, by field name, for example {"Specialization": "Sales"}.

**Outputs**

- `added` (true/false): True if the prospect was added to the list
- `email` (text): The prospect's email
- `prospect` (object): The details sent to Snov.io
- `prospect_id` (text): The prospect's ID
- `updated` (true/false): True if an existing prospect was updated

**Example output**

```json
{
  "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 (`emails`, list, required): Up to 10 email addresses to check.

**Outputs**

- `count` (number): How many
- `results` (list): One per address
- `task_hash` (text): Snov.io's ID for the check
- `valid_count` (number): How many are valid

**Example output**

```json
{
  "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
}
```
