Zapmail
Overview
API Reference
Overview
API Reference
  1. Capabilities
  • Introduction
  • Quickstart
  • Authentication
  • MCP
  • Versioning
  • Errors
  • Webhooks
  • Rate Limits
  • Pagination
  • Changelog
  • Capabilities
    • Mailboxes
    • Pre-Warmed
    • Deliverability
    • Domains
    • Export to Sequencer
    • Zapbox
    • Team Management
    • ZapShield
    • ZapCare
    • AI Insight
    • Deliverability Tests
    • ZapSites
    • Zapwarm
    • ZapPulse
  • Billing
    • Understanding Zapmail billing
    • Wallet
  1. Capabilities

Zapwarm

Zapwarm automatically warms up your mailboxes so they build sender reputation before and while you send. You pick the mailboxes, start warmup, and read back each mailbox's warmup score and inbox placement.
Before you start: starting warmup uses warmup slots. Unused slots are used first and missing slots are bought from your wallet, so top it up first (see Wallet).

Start and monitor warmup#

1
Find eligible mailboxes
List Mailboxes Eligible For Warmup returns active mailboxes with warmup off that can be started on Zapwarm.
2
Get a quote
Call Get The Zapwarm Quote with mailboxIds. It returns the quote for the eligible mailboxes among them, your wallet balance and whether the wallet covers the purchase.
3
Start warmup
Call Start Zapwarm with mailboxIds and optional settings (dailyEmails from 1 to 40, and warmupIndustry). Unused slots are used first and missing slots are bought from the wallet. If the wallet cannot cover them, warmup starts on as many mailboxes as the unused slots allow and the call returns 402 listing the rest.
4
Tune settings
Edit Zapwarm Settings applies settings to mailboxIds. An empty mailboxIds array applies them to every mailbox that is already warming up. Unset fields keep their current value.
5
Read scores
Get Zapwarm Score returns the warmup score and inbox placement stats for 1 to 200 mailboxes, keyed by mailbox ID. A mailbox with no score yet, or not found in your account, returns null.
6
Stop warmup
Turn Off Zapwarm switches warmup off for the selected mailboxes.
This can charge your wallet. Starting warmup buys missing slots from the wallet. Use the quote first to see the cost and whether your balance covers it.
Related: Mailboxes, Pre-Warmed, Wallet.
Previous
ZapSites
Next
ZapPulse
Built with