![\"note\"](\"https:\/\/snov.io\/knowledgebase\/wp-content\/themes\/knowledgebase-n\/assets\/img\/ph_circle-wavy-warning.svg\")
<\/div>\nEmail Warm-up API methods<\/a><\/p>\n What you can do with the Email Warm-up API:<\/strong><\/p>\n 1) Connect accounts and start warm-ups in bulk through API requests<\/p>\n 2) Choose a sending strategy based on your outreach stage \u2014 progressive to prepare accounts or steady to maintain reputation<\/p>\n 3) Warm-up on Gmail, Microsoft, or other SMTP providers<\/p>\n 4) Control sending limits and settings at each warm-up stage<\/p>\n 5) Pull statistics to track account progress<\/p>\n<\/div>\n<\/div>\n You'll need two things to use the Email Warm-up API: a connected email account and API credentials for authentication.<\/p>\n Email account<\/strong><\/p>\n At least one sender email account must be connected to your workspace \u2014 either in the app<\/a> or via the Add email account API method<\/a>.<\/p>\n Authentication<\/strong><\/p>\n All Snov.io API requests require an access token. To generate it:<\/p>\n The access token is valid for 1 hour (3600 seconds).<\/p>\n<\/div>\n Here are the API methods broken down by workflow stage:<\/p>\n Warm up a sender account before using it in outreach. This method starts a new warm-up campaign with the settings you specify.<\/p>\n Required input:<\/strong><\/p>\n The required parameters set up your warm-up basics \u2014 which account to warm up and how many emails it should send per day.<\/p>\n Optional input:<\/strong><\/p>\n The optional parameters let you fine-tune your warm-up strategy, email content, and which providers you're warming up against.<\/p>\n You can also improve performance with advanced options like a premium sender pool (business domains only), custom tracking domains, and dynamic proxy.<\/p>\n Get an overview of all warm-up campaigns across your sender accounts, with the option to filter by status or paginate through results.<\/p>\n Required input:<\/strong><\/p>\n none \u2014 this returns all your warm-ups if you don't specify any optional parameters<\/p>\n Optional input:<\/strong><\/p>\n The optional parameters let you filter by campaign status and control pagination \u2014 narrowing results down to active, paused, completed, or failed campaigns, and choosing how many results to show per page.<\/p>\n Review the current configuration and status of a warm-up campaign.<\/p>\n This method returns the full campaign details \u2014 including strategy settings, daily limits, current deliverability stats, and the connected email account \u2014 so you can monitor progress and verify settings before making changes.<\/p>\n Required input:<\/strong><\/p>\n Adjust warm-up strategy, daily limits, status, or content settings without restarting the campaign.<\/p>\n This method partially updates an existing warm-up campaign \u2014 only the fields you pass are changed; all other settings remain as they were.<\/p>\n Required input:<\/strong><\/p>\n Optional input:<\/strong><\/p>\n Every other optional parameter works the same way as in the Create warm-up campaign<\/a> method, so you can adjust any part of your warm-up configuration.<\/p>\n\n
<\/div>\nBefore you start<\/strong><\/h2>\n
\n
Create warm-up campaign<\/strong><\/h2>\n
\n
email_account_id<\/code><\/span> \u2014 the email account you want to warm up<\/li>\nper_day<\/code><\/span> \u2014 how many warm-up emails to send each day. You can set this anywhere from 1 to 1000 emails per day<\/strong>, depending on your plan. See warm-up limits here.<\/a><\/li>\n<\/ul>\n\n
strategy<\/code><\/span> \u2014 how fast to ramp up sending: progressive<\/code><\/span> (default) gradually increases your daily volume, while steady<\/code><\/span> keeps it at a fixed amount throughout<\/li>\nfrom<\/code><\/span> \u2014 the starting daily volume when using the progressive<\/code><\/span> strategy. Choose between 1 and 5, and make sure it's no higher than your per_day<\/code><\/span> goal<\/li>\nincrease<\/code><\/span> \u2014 how much to grow the daily volume each day when using the progressive<\/code><\/span> strategy. Choose between 1 and 5<\/li>\nemail_content<\/code><\/span> \u2014 what content to send during warm-up: autogenerated<\/code><\/span> (default) lets Snov.io generate it with AI, or specific<\/code><\/span> lets you provide your own template<\/li>\nsubject<\/code><\/span> \u2014 your custom email subject line (1\u2013200 characters). Needed if you set email_content<\/code><\/span> to specific<\/code><\/span><\/li>\nbody<\/code><\/span> \u2014 your custom email body (1\u201310000 characters). Needed if you set email_content<\/code><\/span> to specific<\/code><\/span><\/li>\nreply_rate<\/code><\/span> \u2014 what percentage of incoming warm-up emails get a reply. Choose between 10 and 45. Defaults to 30<\/li>\ncampaign_deadline<\/code><\/span> \u2014 the date your warm-up should stop (YYYY-MM-DD). Leave this out if you don't want a deadline<\/li>\nproviders<\/code><\/span> \u2014 which email providers to warm up against. Choose from gmail<\/code><\/span>, microsoft<\/code><\/span>, or other<\/code><\/span><\/li>\nsend_to_paid_domain<\/code><\/span> \u2014 whether to also send warm-up emails to paid domains. Defaults to false<\/code><\/span><\/li>\nenable_ctd<\/code><\/span> \u2014 turn on a custom tracking domain for this warm-up. Defaults to false<\/code><\/span><\/li>\nenable_proxy<\/code><\/span> \u2014 turn on dynamic proxy for this warm-up. Defaults to false<\/code><\/span><\/li>\nschedule_id<\/code><\/span> \u2014 the sending schedule you want to attach to this warm-up<\/li>\ntemplate_name<\/code><\/span> \u2014 the name of a saved email template you'd like to use<\/li>\n<\/ul>\nGet list of warm-up campaigns<\/strong><\/h2>\n
\n
page<\/code><\/span> \u2014 which page of results to show. Starts at 1 (the default)<\/li>\nper_page<\/code><\/span> \u2014 how many results to show per page. Choose from 20<\/code><\/span>, 50<\/code><\/span>, or 100<\/code><\/span>. Defaults to 20<\/li>\nstatus<\/code><\/span> \u2014 narrow results down to a specific status: active<\/code><\/span>, paused<\/code><\/span>, completed<\/code><\/span>, or error<\/code><\/span>. Leave this out to get all warm-up campaigns<\/li>\n<\/ul>\nGet warm-up campaign info<\/strong><\/h2>\n
id<\/code><\/span> \u2014 the warm-up campaign you want to look up. You can get this from the Get list of warm-up campaigns<\/a> method response<\/p>\nUpdate warm-up campaign<\/strong><\/h2>\n
id<\/code><\/span> \u2014 the warm-up campaign you want to update. You can get this from the Get list of warm-up campaigns<\/a> method response<\/p>\nmake_endless: true<\/code><\/span> \u2014 remove the campaign's deadline so the warm-up keeps running indefinitely. This overrides any deadline you'd set previously<\/p>\n