How to use Snov.io tools via API

Snov.io's main tools are available via REST API. Find prospects, enrich their data, verify emails, run outreach campaigns, and track performance — all through the API.

Snov.io APIs

Find the methods available in each API category below:

Domain Search API

Data Enrichment API

Email Finder API

Email Verifier API

Prospect Management API

Email Accounts API

Email Warm-up API

Multichannel Campaigns API

Campaign Content API

Analytics & Reporting API

Webhooks

How to get your API access token

• Send your API User ID and API Secret in the request body. You'll receive an access token in response
• The access token is valid for 1 hour (3600 seconds)
• Include the token in the Authorization header of every request

Domain Search API

Find company info, prospect profiles, and email addresses by domain. In this API, POST methods start a search returning a task_hash, then GET retrieves results.

See full API methods details in API documentation.

Method	Endpoint	Purpose
POST	https://api.snov.io/v2/domain-search/start	Request company info by domain
GET	https://api.snov.io/v2/domain-search/result/{task_hash}	Get company info results
POST	https://api.snov.io/v2/domain-search/prospects/start	Search prospects by domain + position filters
GET	https://api.snov.io/v2/domain-search/prospects/result/{task_hash}	Get prospect search results
POST	https://api.snov.io/v2/domain-search/domain-emails/start	Search emails by domain
GET	https://api.snov.io/v2/domain-search/domain-emails/result/{task_hash}	Get domain email results
POST	https://api.snov.io/v2/domain-search/generic-contacts/start	Search generic/role-based emails
GET	https://api.snov.io/v2/domain-search/generic-contacts/result/{task_hash}	Get generic contact results

Data Enrichment API

Expand your existing datasets with additional B2B data points from Snov.io's database.

See full API methods details in API documentation.

Method	Endpoint	Purpose
POST	https://api.snov.io/v2/company-domain-by-name/start	Enrich domain name from company's name
POST	https://api.snov.io/v2/emails-by-domain-by-name/start	Enrich email address from prospect's name and domain
POST	https://api.snov.io/v2/li-profiles-by-urls/start	Enrich person profile from LinkedIn URL
GET	https://api.snov.io/v1/get-profile-by-email	Enrich person profile from email address

Email Finder API

Get full prospects with job titles and verified emails from their name + domain or company name.

See full API methods details in API documentation.

Method	Endpoint	Purpose
POST	/v2/emails-by-domain-by-name/start	Find emails from name + domain (bulk: up to 10 per request)
GET	/v2/emails-by-domain-by-name/result	Retrieve found emails
POST	/v2/company-domain-by-name/start	Find domain from company name (bulk: up to 10 per request)
GET	/v2/company-domain-by-name/result	Retrieve company domains

Email Verifier API

Check email deliverability with multistep verification. Returns valid, not_valid, or unknown status with detailed reasons. Validate your outsorced lists or integrate verification to check email at sign up.

See full API methods details in API documentation.

Method	Endpoint	Purpose
POST	https://api.snov.io/v2/email-verification/start	Submit emails for verification (verify up to 10 emails in one request)
GET	https://api.snov.io/v2/email-verification/result	Get verification results

Prospect Management API

Manage prospects in your account. Automate routine tasks like creating lists and organizing prospects by segment.

See full API methods details in API documentation.

Method	Endpoint	Purpose
POST	https://api.snov.io/v1/add-prospect-to-list	Add prospect to a list
POST	https://api.snov.io/v1/lists	Create new prospect list
GET	https://api.snov.io/v1/prospect-list	View prospects in list

Email Accounts API

Manage email sending accounts. Connect, configure, and check account status.

See full API methods details in API documentation.

Method	Endpoint	Purpose
POST	https://api.snov.io/v2/sender-accounts/emails	Add new email account
PATCH	https://api.snov.io/v2/sender-accounts/emails/{id}	Update email account settings
GET	https://api.snov.io/v2/sender-accounts/check-sender-status	List all sender accounts
GET	https://api.snov.io/v2/sender-accounts/emails	Check account connection status

Email Warm-up API

Start warm up for sender accounts before outreach to protect deliverability and improve sender reputation.

See full API methods details in API documentation.

Method	Endpoint	Purpose
POST	https://api.snov.io/v2/warm-up	Create warm-up campaign
PATCH	https://api.snov.io/v2/warm-up/{id}	Update warm-up settings
GET	https://api.snov.io/v2/warm-up	List warm-up campaigns
GET	https://api.snov.io/v2/warm-up/statistics/{id}	Get daily warm-up stats

Multichannel Campaigns API

Manage entire outreach workflow — create, configure, launch, and monitor campaigns.

See full API methods details in API documentation.

Method	Endpoint	Purpose
POST	https://api.snov.io/ v2/campaigns/create	Create new campaign
GET	https://api.snov.io/ v2/campaigns/{campaign_id}	Get campaign details
PATCH	https://api.snov.io/ v2/campaigns/{campaign_id}	Update campaign settings
POST	https://api.snov.io/ v2/campaigns/{campaign_id}/action	Change campaign status (launch/pause/resume/complete/archive)
DELETE	https://api.snov.io/ v2/campaigns/{campaign_id}	Delete campaign
GET	https://api.snov.io/ v2/campaigns/schedules	Get sending schedules added in the app
GET	https://api.snov.io/ v2/blacklists	Get do-not-contact lists

Campaign content API

Manage email step content (subject lines and bodies) within campaign sequences.

See full API methods details in API documentation.

Method	Endpoint	Purpose
POST	https://api.snov.io/ v2/campaigns/{campaign_id}/ steps/{step_id}/content/create	Create/upsert email content
GET	https://api.snov.io/ v2/campaigns/{campaign_id}/ steps/{step_id}/content/{content_id}	Get email content
PATCH	https://api.snov.io/ v2/campaigns/{campaign_id}/ steps/{step_id}/content/{content_id}	Update email content
DELETE	https://api.snov.io/ v2/campaigns/{campaign_id}/ steps/{step_id}/content/{content_id}	Delete email content

Analytics & Reporting API

Retrieve engagement data and campaign performance across email and LinkedIn channels.

See full API methods details in API documentation.

Method	Endpoint	Purpose
GET	https://api.snov.io/ v2/statistics/campaign-analytics	Aggregated campaign metrics based on the applied filters
GET	https://api.snov.io/ v2/campaigns/[campaign_id]/progress	Campaign completion progress
GET	https://api.snov.io/ v2/campaigns/[campaign_id]/all-replies	Campaign replies data (email + LinkedIn)
GET	https://api.snov.io/ v1/get-emails-replies	Campaign replies (email only)
GET	https://api.snov.io/ v1/get-emails-opened	Email open data
GET	https://api.snov.io/ v1/get-emails-clicked	Link click data
GET	https://api.snov.io/ v1/emails-sent	Sent emails log
GET	https://api.snov.io/ v1/get-user-campaigns	List all campaigns

Webhooks API

Set up automations that react to prospect engagement and campaign activity in real time. Webhooks can send activity data from email and LinkedIn campaigns to your endpoint URL. This includes replies, autoreplies, email opens, clicks, sequence completion, and more. See full list of webhooks here.