InboxWarm Has a Public Email Warmup API
Automate warmup, pull deliverability data, and manage every inbox programmatically — 27 REST endpoints, included with every plan.
Last updated:
TL;DR
InboxWarm has a public REST API with 27 endpoints across 5 categories — Email Accounts, Warmup, Deliverability, Reports, and System. It lets you connect inboxes, start and stop warmup, and pull deliverability scores and reports into your own tools. Access is included in every plan at no extra cost: sign up, generate a key in Developer Kit > API Integration, and make your first call in under 5 minutes.
Why use the InboxWarm API?
The InboxWarm API exists so you can run email warmup and deliverability monitoring from your own product, scripts, and dashboards instead of the InboxWarm web app.
Automate warmup start and stop
Kick off warmup the moment a new inbox is provisioned and pause it when a campaign goes live — no dashboard clicks required.
Pull deliverability data into your own dashboards
Feed setup scores, DNS health, inbox placement, and daily warmup reports straight into your BI tool or internal admin.
Connect InboxWarm to your product or internal tools
Manage inboxes programmatically from your onboarding flow, CRM, or agency back office using simple REST calls.
Included in every plan, no extra cost
Every InboxWarm plan ships with full API access at no additional charge — generate a key and start calling endpoints today.
What can you do with InboxWarm's API?
The email warmup API covers 27 REST endpoints across 5 categories; the full endpoint-by-endpoint reference lives in the public API reference.
Email Accounts
Connect Gmail, Microsoft, or SMTP/IMAP inboxes, check their connection health, and manage them one by one or in bulk.
Warmup
Start, stop, and configure email warmup for any inbox — including bulk actions across up to 50 inboxes in a single call.
Deliverability
Check setup scores, run live DNS health checks (SPF, DKIM, DMARC, MX), and measure inbox-vs-spam placement per provider.
Reports
Pull daily warmup reports, account-wide dashboard summaries, and async CSV exports into your own dashboards and tools.
System
Liveness and rate-limit status endpoints so you can monitor your integration without spending your request quota.
Full reference
Request and response examples for every endpoint, error codes, and auth details.
Browse the API referenceHow do I get started with the InboxWarm API?
You can make your first InboxWarm API call in under 5 minutes: sign up, generate an API key, and send one curl request — no OAuth dance, no SDK to install.
- 1
Create an InboxWarm account — the 10-day free trial needs no credit card.
- 2
Generate an API key from Developer Kit > API Integration in the app.
- 3
Call any endpoint — for example, list your connected email accounts:
curl "https://app.inboxwarm.ai/api/v1/email-accounts?api_key=YOUR_API_KEY"That's it — the response is a JSON list of your inboxes with their warmup status. From there, start warmup with a single POST request.
How do I authenticate with InboxWarm's API?
Every request is authenticated with your API key; where the key goes depends on the HTTP method you're using.
Query parameter
Append your API key to the URL as the api_key query parameter.
?api_key=YOUR_API_KEYJSON body field
Include your API key as the apiKey field inside the JSON request body.
{ "apiKey": "YOUR_API_KEY", ... }Generate and manage API keys from Developer Kit > API Integration in the InboxWarm app. Each key grants full account access across every endpoint.
What can you build with the InboxWarm API?
Teams use the InboxWarm email deliverability API to embed warmup and inbox monitoring into products, BI pipelines, and agency workflows — here are three common patterns.
Trigger warmup from your onboarding flow
When your product provisions a new sending inbox for a customer, call POST /email-accounts to connect it and POST /warmup-settings/{id}/start to begin warmup automatically — the inbox is warming before your customer finishes onboarding.
Pull weekly deliverability scores into your BI tool
Schedule a weekly job that calls POST /deliverability-score/{id} and POST /reports/bulk, then push the inbox-vs-spam rates into Looker, Metabase, or Google Sheets so your whole team sees deliverability trends next to campaign metrics.
Monitor client inboxes from your agency dashboard
Agencies managing dozens of client inboxes use POST /email-accounts/bulk-status and GET /dashboard to surface auth errors, health scores, and warmup states in one internal view — and POST /warmup-settings/bulk-action to fix issues in bulk.
What are the rate limits, and what does the API cost?
The default rate limit is 20 requests per minute per API key, and API access is included with every InboxWarm plan at no extra cost.
20 req/min
Default limit per API key. Check live usage anytime via GET /rate-limit — it doesn't count against your quota.
$0 extra
API access is included in every plan — no separate API tier, no usage fees, no paid add-on. See pricing.
Frequently Asked Questions
Yes. InboxWarm has a public REST API with 27 endpoints across 5 categories: Email Accounts, Warmup, Deliverability, Reports, and System. It is available to every customer on every plan at no extra cost.
Sign up for InboxWarm (10-day free trial, no credit card required), then open Developer Kit > API Integration in the app to generate and manage your API keys. Each key grants full account access across every endpoint.
You can connect and manage email accounts, start and stop warmup, read warmup settings, check setup and deliverability scores, run DNS health checks, and pull daily warmup reports and dashboard summaries into your own tools.
InboxWarm uses a mixed authentication scheme based on the HTTP method: GET and DELETE requests send your API key as the api_key query parameter, while POST requests send it as an apiKey field inside the JSON body. No OAuth flow is required.
The default rate limit is 20 requests per minute per API key. You can check your current usage at any time with GET /rate-limit — that call does not count against your quota.
API access is included in every InboxWarm plan at no extra cost. There is no separate API tier, usage fee, or paid add-on.
Yes. InboxWarm provides a Postman collection with a mock server so you can explore and test every endpoint before writing any code. You'll find it alongside your API keys in Developer Kit > API Integration in the app.
The full endpoint-by-endpoint reference for all 27 endpoints is publicly available at https://inboxwarm.ai/api/docs/ — no login required.
Yes. Use POST /warmup-settings/{emailAccountId}/start and POST /warmup-settings/{emailAccountId}/stop to control warmup for a single inbox, or POST /warmup-settings/bulk-action to start or stop warmup for up to 50 inboxes in one call.
Yes. The API includes bulk endpoints for account connection (up to 20 inboxes), warmup start/stop (up to 50 inboxes), account status (up to 50 inboxes), account deletion (up to 20 inboxes), and daily reports (up to 50 inboxes per request).
Ready to automate your email warmup?
Get your API key in minutes — 27 endpoints, 10-day free trial, no credit card, and API access included in every plan.