1. Subscriptions
Cold Mail Reseller
  • Cold Mail Reseller API Documentation
  • Users
    • Retrieve all users
      GET
    • Get User Details
      GET
    • Create User
      POST
    • Update User Details
      PUT
    • Delete User
      DELETE
  • Geo
    • Get Countries List
      GET
    • Get States of a Country
      GET
  • Domains
    • Renewal
      • Domain Renewal Overview
      • Get domain renewal pricing
      • Renew domain
      • Enable or disable domain auto-renew
    • Get Domains For User
      GET
    • Suggest Available Domains
      POST
    • Get Single Available Domain
      POST
    • Check If Workspace Exists
      POST
    • Add domain forwarding
      POST
    • Add email forwarding
      POST
    • Add Google Client ID to Domain
      POST
    • Remove domains
      DELETE
  • Dns
    • Get dns records for a domain
      GET
    • Adds dns record
      POST
    • Update dns records
      PUT
    • Delete dns records
      DELETE
  • Orders
    • Get Order Details
    • Get Order Status
    • Creates order json
    • Order mailboxes (json)
    • Process the Order
    • Create Order
    • Add mailboxes to a subscription
  • Mailboxes
    • Get mailboxes for user
    • Get mailbox details by id
    • Get Mailbox Admin Details
    • Update mailbox details
    • Remove mailbox
  • Subscriptions
    • 1+ Year Subscriptions
      • One Plus Year Subscription Overview
      • Subscription Recreation
    • Get All Subscriptions
      GET
    • Renew Subscriptions
      POST
    • Toggle Auto renewal
      POST
    • Cancel Subscription
      POST
  • Webhooks
    • Overview
    • Events
      • Mailbox Events
      • Prewarmup Events
      • Domain Events
      • Subscription Events
  • Export
    • Platform
      • Platform Exports API
      • Get Connected Platforms
      • Add Platform Credentials
      • Remove Platform Credential
      • Export Mailboxes
    • Re-export a mailbox (Oauth)
  • Pre-warmup
    • Sandbox
      • Sandbox Pre-Warmup Integration
      • [SANDBOX] - Get All Pre-Warmup Mailboxes
      • [SANDBOX] - Order Pre-Warmup Mailboxes
      • [SANDBOX] - Reset Pre-Warmup Data
    • Get All Pre-Warmup Mailboxes
    • Order Pre-Warmup Mailboxes
  • Get Wallet Details
    GET
  • Send error
    POST
  1. Subscriptions

Cancel Subscription

POST
/subscriptions/cancel
Cancels an active subscription and deletes the associated workspace immediately. Either domain or subscription ID must be provided.

Request Body#

FieldTypeRequiredDescription
subscriptionIdstringNo*Unique identifier of the subscription
domainstringNo*Domain associated with the subscription
*Note: Either subscriptionId or domain must be provided.
Important: If your subscription is set to auto-renew, please cancel it at least 24 hours before the subscription expiry date. Cancellation requests submitted within 24 hours of expiry may not process in time and could result in an automatic renewal charge.

Request

Authorization
API Key
Add parameter in header
cmr-x-api-key
Example:
cmr-x-api-key: ********************
or
Body Params application/json

Examples
{
    "domain": "clientapp.co"
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location 'https://customers.coldmailreseller.com/api/v1/integration/subscriptions/cancel' \
--header 'cmr-x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "domain": "clientapp.co"
}'

Responses

🟢200Success
application/json
Bodyapplication/json

Examples
{
  "status": 200,
  "message": "Subscription cancelled successfully",
  "actionId": "ACT_7a078272-0fa7-4db4-a85b-c78697dacea1"
}
🟠400 Bad Request
🟠404Not Found
Modified at 2026-06-23 16:21:02
Previous
Toggle Auto renewal
Next
Overview
Built with