Klaviyo
Shopify
Mailchimp
Omnisend
HubSpot
SendGrid
Brevo
Sendlane
Customer.io
Mailgun
Amazon SES
Ongage
ExpertSender
Zoho Mail
GMX MailGreater automation
Automate routine tasks and workflows to boost productivity and
free up time for more strategic initiatives
Warmy developer platformGet full access to
Get full access to
the
Warmy API
Warmy’s API provides everything you need
to integrate a
top-tier email deliverability
tool into your website.
Skip the coding
and jump straight to the
next step!
How to use the API?
Help your users increase email
deliverability and build up
domain
reputation with Warmy’s
Email Warm-Up API
1
Get An API Key
To get access to the API, please schedule a short call with us
2
Test The API Endpoints
Once you receive your API Key, the next step is to confirm that your API Endpoints are working as expected
3
Launch The New Feature On Your Website
Grow your business and make your clients happy!
Why teams build on WarmyThe benefits of
The benefits of
using an API
Boost efficiency by leveraging APIs to
automate
processes and create
seamless connections,
gaining the
following benefits
Increased efficiency
By integrating with this tool and other systems,
APIs streamline operations
Cost savings
Minimize manual interventions and lower costs by automating processes and improving data accuracy
Innovation and flexibility
APIs provide the flexibility to innovate using Warmy.io AI-powered intelligence tools and integrations, giving you a competitive edge
You will be in a
good
company
100M+
Warm up emails
sent by Warmy.io
30+
Dev teams have launched a
tool with Warmy’s API
You
Make the best of
your business!
1000+ businesses rely on Warmy
Test all features for free. No credit card required
No Credit Card Required | Cancel Anytime
Developer APIGet Full Access
Get Full Access
To Best Email
Warm-Up
API SolutionGet Full Access To The Most Advanced Email
Deliverability API Solution
Everything you need to integrate a high-
end
deliverability tool in your website
Email warm-up API
What’s Available In The Warmy Email Warm-Up API
An email warm-up API lets you programmatically connect mailboxes, configure warm-up activity, and monitor sender reputation without managing every account manually. Warmy’s API enables SaaS platforms, agencies, and high-volume teams to integrate automated email warm-up directly into their products and workflows.
What Is An Email Warm-Up API?
An email warm-up API is an interface that allows software to create, configure, start, pause, and monitor email warm-up automatically. It is primarily used by SaaS platforms, agencies, and teams managing many mailboxes - cases where a warm-up dashboard alone does not scale.
How It Works
- 1Authenticate in minutesGenerate an API key in your workspace and start calling the REST endpoints over HTTPS.
- 2Connect any mailboxGmail and Google Workspace, Outlook and Microsoft 365, Zoho, Yahoo, iCloud, AOL, GMX, Brevo, Roundcube, SendGrid, Amazon SES, Mailgun, Elastic Email - or any provider with standard SMTP/IMAP.
- 3Activate warm-up at scaleSet volume, ramp-up speed and schedule per mailbox, then launch hundreds of them with a single call.
- 4Track reputation in real timePull deliverability scores, placement, activity and health data on demand, or receive it through webhooks.
90+
Documented endpoints
20+
Resource groups
60/min
Request rate limit
REST
JSON over HTTPS
What You Can Automate
| Create a mailbox | Connect Google Workspace, Microsoft 365, or SMTP/IMAP accounts from your own app |
|---|---|
| List and read mailboxes | Fetch every mailbox in the workspace or the full detail of a single one |
| Update mailbox settings | Change sending settings, language, and email topic per mailbox |
| Update mailbox state | Activate, pause, or resume warm-up without opening the dashboard |
| Reconnect mailbox | Re-authorise a mailbox after a provider connection failure |
| Health checks | Trigger a health check for one mailbox or for all of them at once |
| Change tariff plan | Move a mailbox to another plan type programmatically |
| Custom headers | Create, read, update, and delete custom headers per mailbox |
| Delete mailbox | Remove an account and stop all warm-up activity for it |
Technical Reference
Base URL
https://api.warmy.io
Protocol
REST over HTTPS, JSON request and response bodies
Authentication
Authorization: Bearer <your token> together with your Holder-Uid header
API keys
Generated in Workspace → Settings → API Keys, and revocable at any time
Rate limits
60 requests per minute; 30 per minute for domain providers, returning 429
Errors
Every failure returns a readable message plus a stable error_key to branch on
Retries
Retry 502 and 503 with exponential backoff; honour retry_after on 429
Spec
OpenAPI 3.0 specification available as a YAML download for your API client
Who it's for
Built For SaaS Platforms, Agencies, And Large Teams
SaaS platforms
Embed warm-up into onboarding or offer it as a native feature of your product.
Email & lead-gen agencies
Manage every client mailbox without switching between accounts.
Sales infrastructure providers
Add warm-up to mailbox provisioning and sending-infrastructure workflows.
Enterprise teams
Standardise warm-up across many domains, mailboxes, and users.
Email Warm-Up API FAQs
It is an interface that lets your software create, configure, start, pause, and monitor email warm-up automatically, instead of doing it by hand in a dashboard.