Before you start<\/a><\/p>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n Campaigns API methods<\/a><\/p>\n The Campaigns API<\/a> is one of several API categories available<\/a> to automate your work in Snov.io.<\/p>\n Use it to build and run multichannel outreach campaigns directly from your code, without manually setting everything up in your Snov.io account.<\/p>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n What you can do with the Campaigns API:<\/strong><\/p>\n 1) Run campaigns automatically.<\/strong> Create, edit, and launch campaigns through API requests.<\/p>\n 2) Get real-time webhooks.<\/strong> Track replies, accepted connection requests, InMail responses, autoreplies, and other prospect actions as they happen.<\/p>\n 3) Sync activity data to your tools.<\/strong> Send campaign and recipient activity data straight to your CRM, dashboards, or analytics platforms.<\/p>\n<\/div>\n<\/div>\n<\/div>\n Find new prospects<\/strong><\/p>\n If you need to source leads, use the Email Finder API<\/a> to find prospects and company contacts.<\/p>\n Verify existing emails<\/strong><\/p>\n Verify email addresses from your CRM, event registrations, or third-party databases before outreach using the Email Verifier API<\/a>. Reduce bounce rates and improve deliverability.<\/p>\n Organize prospects into a list<\/strong><\/p>\n Create a list for your prospects and add them using the prospect list API methods. Use the Here are the API methods broken down by workflow stage:<\/p>\n These methods help retrieve your existing sending configuration that has already been added to your account. You'll need the IDs for each of the below settings when using the API method to create a campaign.<\/p>\n Get the sender account ID and confirm daily limits before assigning the account to a campaign.<\/p>\n Returns all connected email accounts with their sender names, email addresses, daily limits, and provider info.<\/p>\n Verify the account connection is active and has no errors before using it in a campaign.<\/p>\n Required input:<\/strong><\/strong><\/p>\n Get your do-not-contact lists<\/strong><\/p>\n Retrieve the do-not-contact lists created in your account.<\/p>\n Get the do-not-contact list ID you'll be assigning to a campaign to automatically exclude specific contacts from receiving the sequence<\/p>\n Get the schedule ID you'll be using for a campaign.<\/p>\n Returns all schedules created in your account, including timezone, active days, and sending windows.<\/p>\n These methods let you connect, configure, and warm up email accounts.<\/p>\n Connects an email account using SMTP and IMAP settings, so you can assign it as a sender in your campaigns.<\/p>\n Required input:<\/strong> <\/strong><\/p>\n The account's SMTP credentials and server settings.<\/p>\n Optional input<\/strong><\/p>\n Updates the settings of an existing sender account \u2014 for example, daily sending limits or display name \u2014 without reconnecting it. Only the fields you include in the request will be updated; everything else stays as is.<\/p>\n Required input:<\/strong><\/strong><\/p>\n Required input:<\/strong><\/strong><\/strong><\/p>\n These methods let you set up campaigns with their full configuration: sequence steps (email + LinkedIn), schedule, tracking, sender accounts, recipient list, and sending settings.<\/p>\n Create a campaign and get the campaign ID you'll use in all subsequent API calls.<\/p>\n Creates a new campaign draft with the core settings required for launch.<\/p>\n Required input:<\/strong><\/strong><\/p>\n Campaign name, sending schedule, and at least one sender account.<\/p>\n Check a campaign's current settings and status before making updates or launching.<\/p>\n Retrieves full details about a specific campaign \u2014 status, sender accounts, sending settings, recipients, and sequence steps.<\/p>\n Required input:<\/strong><\/strong><\/p>\n Update a campaign<\/strong><\/p>\n Update campaign settings before launch or while the campaign is paused. Only the settings you include in the request body will be changed.<\/p>\n Required input:<\/strong><\/strong><\/p>\n Control the campaign lifecycle \u2014 start outreach, pause it, or close the campaign when done. This method updates the campaign to a new status: active, paused, resumed, complete, or archived.<\/p>\n\n
\n
![\"learn\"](\"https:\/\/snov.io\/knowledgebase\/wp-content\/themes\/knowledgebase-n\/assets\/img\/fluent_chat-warning-16-regular.svg\")
<\/div>\n![\"note\"](\"https:\/\/snov.io\/knowledgebase\/wp-content\/themes\/knowledgebase-n\/assets\/img\/ph_circle-wavy-warning.svg\")
<\/div>\nBefore you start using the Campaigns API<\/strong><\/h2>\n
Prepare basic account setup<\/h3>\n
\n
Prepare your prospect list<\/h3>\n
recipient_list_id<\/code><\/span> during campaign creation. Continue adding new leads to the same list via the API after the campaign launches to automatically enroll them in the sequence.<\/div>\nlist_id<\/code><\/span> when creating campaigns.<\/p>\n<\/div>\n\n
Campaigns API methods<\/strong><\/h2>\n
<\/div>\nCheck sending setup<\/strong><\/h3>\n
Get your sender email accounts<\/strong><\/h4>\n
Check sender account SMTP\/IMAP status<\/strong><\/h4>\n
email<\/code><\/span> \u2014 the email address of the sender account to check<\/p>\nGet your campaign schedules<\/strong><\/h4>\n
Manage sender email accounts<\/strong><\/h3>\n
Add a new email account<\/strong><\/h4>\n
sender_name<\/code><\/span>, email_from<\/code><\/span>, password<\/code><\/span>, smtp.host<\/code><\/span>, smtp.port<\/code><\/span>, smtp.encryption<\/code><\/span><\/p>\n\n
![\"tip\"](\"https:\/\/snov.io\/knowledgebase\/wp-content\/themes\/knowledgebase-n\/assets\/img\/academicons_ideas-repec.svg\")
<\/div>\nUpdate an email account<\/strong><\/h4>\n
account_id<\/code><\/span> \u2014 the ID of the sender account to update<\/p>\nStart warm-up<\/strong><\/h4>\n
sender_account_id<\/code><\/span> \u2014 ID of the email account to warm up<\/p>\nper_day<\/code><\/span> \u2014 Daily sending goal, the number of emails sent daily in warm-up. For the initial warm-up, we recommend setting this limit to 40 emails per day. Depending on your plan, this limit can be up to 1000 emails<\/a><\/p>\nstrategy<\/code><\/span> \u2014 Choose the warm-up strategy: progressive to ramp up daily sending volume for new or inactive accounts (from 2 to 40 emails recommended), or steady to maintain sender reputation with a fixed daily volume<\/p>\nemail_content<\/code><\/span> \u2014 You can warm up your own email template to improve its deliverability, or use AI-generated content<\/p>\nCreate & manage campaigns<\/strong><\/h3>\n
Create a new campaign<\/strong><\/h4>\n
name<\/code><\/span>, schedule_id<\/code><\/span>, sender_account_ids<\/code><\/span><\/p>\n<\/div>\nGet campaign info<\/strong><\/h4>\n
campaign_id<\/code><\/span> \u2014 the campaign ID in the request URL<\/p>\ncampaign_id<\/code><\/span> \u2014 the campaign ID in the request URL, plus any fields you want to update<\/p>\nChange campaign statuses<\/strong><\/h4>\n