• Welcome to the Cold Mail Reseller API
    • Domain Protection
    • Get Started
      • Overview
      • Authentication
      • Quick Start
    • Core Concepts
      • Users
      • Domains
      • DNS Management
      • Subscriptions
      • Pre-Warmup
      • Domain Renewal
      • Mailbox Warmup
      • OAuth Exports
      • Platform Exports
      • Mailboxes
      • Sandbox API
      • 1+ Year Subscriptions
    • API Reference
      • Users
        • List Users
        • Get User
        • Create User
        • Update User
        • Delete User
      • Geo
        • List Countries
        • List States
      • Domains
        • Domain Renewal
          • Get Domain Renewal Prices
          • Renew Domains
          • Toggle Domain Auto-Renew
        • Get Domain
        • List Available Aged Domains
        • Order Aged Domains
        • Get Domains by User
        • Check Domain Availability
        • Check Single Domain Availability
        • Check Workspace Existence
        • Set Domain Forwarding
        • Set Email Forwarding
        • Delete Domains
        • Enable Domain Protection
        • Cancel Domain Protection
      • DNS
        • Get DNS Records
        • Add DNS Records
        • Update DNS Record
        • Update Nameservers
        • Delete DNS Record
      • Mailboxes
        • List Mailboxes
        • Get Mailboxes by User
        • Get Mailbox
        • Get Admin Mailbox Details
        • Update Mailbox Details
        • Delete Mailbox
      • Mailbox Warmup
        • Add Warmup to Mailbox
        • Toggle Warmup
        • Update Warmup Settings
        • Delete Warmup Subscription
      • Orders
        • Get Order Status
        • Get Order Details
        • Create Order
        • Create Order (JSON)
        • Create Mailbox Order (JSON)
        • Process Order
      • Subscriptions
        • 1+ Year Subscription
          • Recreate Subscription
        • Get Subscriptions
        • Renew Subscriptions
        • Cancel Subscription
        • Toggle Auto-Renewal
      • Exports
        • Platform Exports
          • Get Platform Credentials
          • Get Platform Workspaces
          • Add Platform Credential
          • Export Mailboxes to Platform
          • Update Platform Credential
          • Remove Platform Credential
        • OAuth Exports
          • Perform OAuth
          • Add Client ID to Domains
      • Pre-Warmup
        • Sandbox
          • Get Sandbox Pre-warmup Domains
          • Order Sandbox Pre-warmup
          • Reset Sandbox Pre-warmup
        • Get Pre-warmup Domains
        • Order Pre-warmup
      • Placement Test
        • Create Placement Order
        • Get Placement Reports
    • Resources
      • Errors
      • Rate Limits
      • Pagination
      • Sandbox
      • MCP
    • Webhooks
      • Overview
      • Events
        • DNS Events
        • Subscription Events
        • Prewarmup Events
        • Mailbox Warmup Events
        • Mailbox Events
        • Domain Events
    • Schemas
      • Error
      • Success
      • MessageResponse
      • User
      • Domain
      • ErrorResponse
      • Mailbox
      • Subscription
      • DnsRecord
      • Error Response
      • Pagination Meta
      • Action Error Response
      • PrewarmupOrderResult
      • OrderCreationResult

    Domain Protection

    Domain protection keeps your sending domains healthy by moving them to premium DNS infrastructure, monitoring them daily for blacklist listings, and replacing them free of charge if they become listed through no fault of your own.
    INFO
    Domain protection is billed monthly per domain. Enable it on any ACTIVE domain by calling POST /integration/domain-protection. Check whether a domain already has protection enabled via Get Domain — look for domainProtectionEnabled: true.

    Quick Reference#

    AspectInformation
    Route prefix/integration/domain-protection
    Payment methodPartner wallet balance
    Billing cycleMonthly per domain
    DNS providerGoogle Cloud DNS
    Blacklist sourcesSURBL, Spamhaus DBL, URIBL
    Check frequencyDaily

    Available Endpoints#

    MethodEndpointDescription
    POST/integration/domain-protectionEnable protection for one or more domains
    DELETE/integration/domain-protectionCancel protection for one or more domains

    What Is Included#

    Premium DNS
    Daily blacklist monitoring
    Free domain replacement

    Enabling Protection#

    1
    Check protection status
    Call GET /domains/domain and check domainProtectionEnabled. Skip domains where this is already true.
    2
    Enable protection
    Call POST /integration/domain-protection with the componentDomainIds of the domains to protect. The partner wallet is charged immediately.
    3
    Confirm activation
    Listen for the domain.protection.success webhook, or poll GET /domains/domain until domainProtectionEnabled is true.

    Cancelling Protection#

    1
    Cancel protection
    Call DELETE /integration/domain-protection with the componentDomainIds to cancel. Domains without an active protection subscription are silently skipped.
    2
    Confirm cancellation
    Protection remains active until the end of the current billing period. After that, domainProtectionEnabled returns to false.

    Error Reference#

    CodeReason
    400Domain protection pricing is not configured for this partner
    402Insufficient wallet balance
    403Domain does not belong to this partner
    404One or more domain IDs were not found
    409All specified domains already have protection enabled
    422Request body failed validation

    Next Steps#

    Enable Domain Protection
    Enable protection on one or more active domains.
    Get Domain
    Check domainProtectionEnabled and current domain status.
    Domains
    Domain registration, forwarding, and lifecycle.
    Modified at 2026-10-03 13:05:10
    Previous
    Welcome to the Cold Mail Reseller API
    Next
    Overview
    Built with