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

ZapShield

ZapShield protects the DNS of your domains. A protected domain's DNS zone is moved to Google Cloud DNS in the background, and dnsShieldEnabled on the domain turns on when the move is done. You pay per domain with a monthly or annual subscription, or buy a lifetime plan with a fixed number of domain slots.
Before you start: ZapShield subscriptions and slots belong to the account, not to a workspace. The lifetime and existing-domain purchases need an active base plan. Fund your wallet first (see Wallet).

Protect domains#

1
Pick domains
List ZapShield Eligible Domains lists ACTIVE domains that can be protected. A domain must not be pre-warmed, must have nameservers, must not already have ZapShield enabled or in progress, and must have been bought through Zapmail or connected with registrar credentials. Filter with contains and sortBy.
2
Use free slots first
Get ZapShield Available Slots returns free slots on lifetime plans. If you have slots, Allocate Domains to ZapShield turns on ZapShield without a new payment. Lifetime slots are used first, then free capacity on a pay-as-you-go subscription. The call fails with a server error when there is no free slot and no active pay-as-you-go subscription.
3
Or buy
Purchase ZapShield buys capacity. planType selects the product: MONTHLY or ANNUAL for pay-as-you-go slots per domain, LTD for a lifetime plan (starter, growth or pro), or EXISTING to protect domains you already own, using free slots first and charging only for the rest.
4
Confirm
Fulfilment is asynchronous and starts after the invoice is paid. Poll GET /dns-shield/subscriptions and List ZapShield Allocated Domains with the subscriptionId until the domains appear.
This charges your wallet. The key owner is charged. MONTHLY and ANNUAL use the wallet balance and, if it is short and auto-recharge is on, charge the saved card for the shortfall; otherwise the request fails with 400. LTD and EXISTING create an invoice that is settled from wallet credit, and any uncovered amount stays due on the hosted invoice at checkoutUrl. Allocating from slots you already own does not charge.

Pricing in the endpoint specification#

PlanPrice
MONTHLYUSD 3.00 per domain per month, or 2.50 once the account has 201 or more ZapShield domains
ANNUALUSD 18.00 per domain per year, or 15.00 at 201 or more domains
LTD starter / growth / proUSD 299 for 30 domains / USD 999 for 100 / USD 2,999 for 500
If an active subscription of the same cycle exists, only the prorated amount is charged. The response shape of Purchase ZapShield differs by planType; see the examples on the endpoint page.

Manage subscriptions#

GET /dns-shield/subscriptions lists pay-as-you-go and lifetime subscriptions, including cancelled ones. It is not paginated.
POST /dns-shield/upgrade-plan upgrades a lifetime subscription: starter to growth or pro, growth to pro. You pay the new plan price minus the price recorded on the current subscription. The tier changes after the invoice is paid, so check requiresPayment and invoiceUrl. Pay-as-you-go subscriptions cannot be upgraded. This charges your wallet for the difference, with any shortfall left on the hosted invoice.
Cancel ZapShield Subscription cancels a subscription immediately. Every domain on it loses ZapShield and its DNS is moved back by a background job, unless Zap Care is still active on the domain. No refund is issued by this endpoint. This cannot be reverted through the API.
Related: Deliverability, Zap Care, Domains.
Previous
Team Management
Next
ZapCare
Built with