• Welcome to the Cold Mail Reseller API
    • Get Started
      • Overview
      • Authentication
      • Quick Start
    • Core Concepts
      • Users
      • Domains
      • DNS Management
      • Mailboxes
      • Subscriptions
      • Pre-Warmup
      • Domain Renewal
      • 1+ Year Subscriptions
      • Mailbox Warmup
      • Platform Exports
      • OAuth Exports
      • Sandbox API
    • 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 Domains by User
        • Check Domain Availability
        • Check Single Domain Availability
        • Check Workspace Existence
        • Set Domain Forwarding
        • Set Email Forwarding
        • Delete Domains
      • 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
        • Set Warmup Status
        • Disable Warmup
      • 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
          • Add Platform Credential
          • Export Mailboxes to Platform
          • 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
        • Domain Events
        • Mailbox Events
        • Subscription Events
        • Prewarmup Events
        • Mailbox Warmup Events
    • Schemas
      • Error
      • Success
      • MessageResponse
      • User
      • Domain
      • ErrorResponse
      • Mailbox
      • Subscription
      • DnsRecord
      • Error Response
      • Pagination Meta
      • Action Error Response
      • PrewarmupOrderResult
      • OrderCreationResult

    Welcome to the Cold Mail Reseller API

    Build a fully white-labeled cold email platform without managing email infrastructure yourself.
    The Cold Mail Reseller API lets you provision domains, create mailboxes, manage subscriptions, automate warmup, and export credentials to sending platforms.
    Your customers interact only with your platform while CMR handles domain registration, mailbox provisioning, and deliverability behind the scenes.
    Whether you're building a lead generation platform, a cold outreach tool, an agency dashboard, or an email SaaS, the API gives you what you need to launch and scale reliable sending infrastructure.

    Start Building#

    Quick Start
    Build your first integration end-to-end in one worked example.
    Authentication
    Generate an API key and authenticate every request.
    Overview
    How the API works and how resources are connected.

    Core Resources#

    Users
    Create and manage the customers on your platform.
    Domains
    Register, renew, and manage domains.
    Mailboxes
    Provision and manage business mailboxes.
    DNS Management
    Configure SPF, DKIM, and DMARC records.
    Subscriptions
    Manage billing, renewals, and cancellations.
    Pre-Warmup
    Order mailboxes that are already warmed and ready to send.

    Platform Features#

    Mailbox Warmup
    Automate sender reputation building for new mailboxes.
    Domain Renewal
    Handle renewals, grace periods, and expiration.
    1+ Year Subscriptions
    Pricing changes once a subscription crosses 12 months.
    Platform Exports
    Push SMTP credentials to a supported sending platform.
    OAuth Exports
    Connect a mailbox to Google or Microsoft directly.
    Sandbox API
    Test order flows without real charges.

    Event-Driven Integrations#

    Every async operation — orders, renewals, warmup, exports — reports completion through a webhook rather than the original request. Start with Webhooks Overview for delivery, retries, and signature verification, then use the event-specific pages below for exact payload shapes.
    Webhooks Overview
    Delivery, retries, and signature verification.
    Domain Events
    Domain registration and renewal events.
    Mailbox Events
    Mailbox creation and update events.
    Subscription Events
    Renewal, past-due, and cancellation events.
    Prewarmup Events
    Pre-warmup order assignment events.
    Mailbox Warmup Events
    Warmup start and removal events.

    Developer Resources#

    Errors
    Status codes, error messages, and retry strategy.
    Rate Limits
    Request limits and how to handle 429 responses.
    Pagination
    page and limit query params on list endpoints.
    Modified at 2026-08-06 06:22:18
    Next
    Overview
    Built with