How to use Snov.io tools via API

Snov.io's tools are available through our REST API. You can access the main features through API requests: sourcing prospects, enriching data and verification, managing full outreach cycle and syncing performance data.

How to get access to API
The API is available on all Sales Suite plans; to use APIs involving the LinkedIn channel, enable LinkedIn Automation tool.If you're on a free plan, you can request a test access by emailing us at help@snov.io. To get started, please tell us about your specific goal so we can better understand your needs and provide guidance.

Snov.io APIs

Here's the list of our 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

Sender Accounts API

Email Warm-up API

Campaigns API

Campaign Content API

Analytics & Reporting API

Webhooks

How to get your API access token

All Snov.io API requests require an access token for authentication. To generate it, use the Authentication method with your API User ID and API Secret: find both in your account settings under the API tab.

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	/v2/domain-search/start/	Request company info by domain
GET	/v2/domain-search/result/{task_hash}	Get company info results
POST	/v2/domain-search/prospects/start	Search prospects by domain + position filters
GET	/v2/domain-search/prospects/result/{task_hash}	Get prospect search results
POST	/v2/domain-search/domain-emails/start	Search emails by domain
GET	/v2/domain-search/domain-emails/result/{task_hash}	Get domain email results
POST	/v2/domain-search/generic-contacts/start	Search generic/role-based emails
GET	/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	/v2/company-domain-by-name/start	Enrich domain name from company's name
POST	/v2/emails-by-domain-by-name/start	Enrich email address from prospect's name and domain
POST	/v2/li-profiles-by-urls/start	Enrich person profile from LinkedIn URL
GET	/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	/v2/email-verification/start	Submit emails for verification (bulk supported)
GET	/v2/email-verification/result	Get verification results by `task_hash`

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	/v1/add-prospect-to-list	Add prospect to a list
POST	/v1/get-prospect-by-id	Find prospect by ID
GET	/v1/get-user-lists	List all prospect lists

Sender Accounts API

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

See full API methods details in API documentation.

Method	Endpoint	Purpose
POST	/v2/sender-accounts/emails	Add new email account
PATCH	/v2/sender-accounts/emails/{account_id}	Update email account settings
GET	/v2/sender-accounts/emails	List all sender accounts
GET	/v2/sender-accounts/check-sender-status	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	/v2/warm-up	Create warm-up campaign
PATCH	/v2/warm-up/{id}	Update warm-up settings
GET	/v2/warm-up	List warm-up campaigns
GET	/v2/warm-up/{id}/daily-statistics	Get daily warm-up stats

Campaigns API

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

See full API methods details in API documentation.

Method	Endpoint	Purpose
POST	/v2/campaigns	Create new campaign
GET	/v2/campaigns/{id}	Get campaign details
PATCH	/v2/campaigns/{id}	Update campaign settings
POST	/v2/campaigns/{id}/state	Change campaign status (launch/pause/resume/complete/archive)
DELETE	/v2/campaigns/{id}	Delete campaign
GET	/v2/campaigns/schedules	List sending schedules
GET	/v2/blacklists	List 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	/v2/campaigns/{id}/steps/{step_id}/content/create	Create/upsert email content
GET	/v2/campaigns/{id}/steps/{step_id}/content/{content_id}	Get email content
PATCH	/v2/campaigns/{id}/steps/{step_id}/content/{content_id}	Update email content
DELETE	/v2/campaigns/{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	/v2/statistics/campaign-analytics	Aggregated campaign metrics
GET	/v2/campaigns/{campaign_id}/progress	Campaign completion progress
GET	/v2/campaigns/{campaign_id}/replies	Campaign replies with sentiment
GET	/v2/campaigns/{campaign_id}/opens	Email open data
GET	/v2/campaigns/{campaign_id}/clicks	Link click data
GET	/v2/campaigns/{campaign_id}/emails-sent	Sent emails log
GET	/v1/get-user-campaigns	List all campaigns

Webhooks API

Set up automations based on events from your campaigns.

Supported webhook events:

email_replied — Triggered when a prospect replies to your email campaign
email_opened — Triggered when a prospect opens your email
email_clicked — Triggered when a prospect clicks a link in your email
linkedin_replied — Triggered when a prospect replies via LinkedIn
linkedin_connection_accepted — Triggered when a LinkedIn connection request is accepted
linkedin_inmail_replied — Triggered when a prospect replies to your LinkedIn InMail
autoreply_detected — Triggered when an autoreply (out-of-office) is detected
prospect_completed — Triggered when a prospect completes all steps in a campaign
campaign_launched — Triggered when a campaign is launched
campaign_paused — Triggered when a campaign is paused