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

Pre-Warmed

Pre-Warmed domains come with mailboxes that have already been warmed up, so you can start sending sooner. You buy a monthly plan that grants allocations, then choose specific domains and assign them to your workspace.
Before you start: the plan is paid from your wallet, so top it up first (see Wallet).

Buy and assign#

1
Check stock
Count Pre-Warmed Domains returns how many pre-warmed domains are available per provider (google and microsoft).
2
Buy a plan
Call Purchase Pre-Warmed Plan with planName (starter, growth or pro, lowercase) as a query parameter. starter is 1 domain with 3 mailboxes for $39, growth is 4 domains with 12 mailboxes for $149, and pro is 10 domains with 30 mailboxes for $339. The plan renews monthly. Each call buys another plan.
3
Wait for the subscription
The subscription is created in the background after payment. Poll List Pre-Warmed Subscriptions until an entry with subscriptionStatus ACTIVE appears.
4
Choose domains
List Pre-Warmed Domains lists available domains with the mailboxes that come with each. Use contains to search by name. Listing is free.
5
Assign
Call Assign Pre-Warmed Domains with domainIds. Each domain uses one domain allocation from your active plans, oldest plan first. The domains are paid for by the plan, so there is no extra charge.
This charges your wallet. The full plan price is charged to the workspace owner's wallet at purchase and again on each monthly renewal. If the balance does not cover the plan, the call returns 400 and nothing is charged. The response is { message, paymentLink, useWallet } without the standard envelope.

Buy more domains on your plan#

To add domains to a plan you already have, call Purchase Pre-Warmed Plan with quantity instead of planName. Each add-on domain comes with its mailboxes at the same tier as your current plan, paid from your wallet. Poll List Pre-Warmed Subscriptions, then assign the new domains as above.

Behaviour to know#

Assignment is asynchronous. The response lists the mailboxes at once, but moving the domains into your workspace happens in the background. Poll GET /mailboxes with the returned IDs, or check List Pre-Warmed Subscriptions.
Every ID passed to assign must be an unsold pre-warmed domain. Duplicate IDs fail with Invalid domain ids. With fewer unused allocations than domains the call returns 400.
The warm-up the seller ran on the mailboxes is switched off when you assign them.
Pre-Warmed mailboxes cannot be scheduled for removal with Schedule Mailbox Removal.
status=PAYMENT_PENDING on the subscriptions list returns past-due subscriptions and recently cancelled ones not cancelled by you; status=CANCELLED returns the rest of the cancelled ones.
Related: Mailboxes, Domains, Understanding Zapmail billing.
Previous
Mailboxes
Next
Deliverability
Built with