Zapmail
Overview
API Reference
Overview
API Reference
  1. Overview
  • 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. Overview

Changelog

This page records changes to the public API that affect integrations, newest first.

October 13, 2026#

Unified provider launch#

Google Workspace and Microsoft 365 are now served together. Responses are no longer scoped to a single email provider, and you no longer choose a provider with a request header.
What changed:
The x-service-provider header is removed. It is ignored; stop sending it.
List and detail responses include resources from both providers in one result.
Each resource carries a serviceProvider field with the value GOOGLE, MICROSOFT or null.
null can appear on subscriptions and on domains that have no mailbox yet. Never treat null as Microsoft.
A domain takes the provider of the first mailbox assigned to it. Do not cache a domain's provider before it has mailboxes.
What to do:
1.
Remove x-service-provider from your requests.
2.
Read serviceProvider from each resource instead of inferring the provider from the request.
3.
Handle null, and re-read the provider after a mailbox is assigned instead of caching it.
See Migrating From v2 To v3 for the other header and response changes.

April 2026#

v3 released#

Version 3 of the API is available at https://api.zapmail.ai/api/v3 and is the active version.
v3 is the version to use for new integrations and the only version that receives new features.
v2 moves to maintenance: critical bug fixes and security patches only. v2 reaches end of life in January 2028.
v1 stays deprecated. It reaches end of life in April 2027.
The route differences between v2 and v3, and what to change when you move, are in Migrating From v2 To v3. Lifecycle dates are in Versioning.
Previous
Pagination
Next
Mailboxes
Built with