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

Renew Subscriptions

POST
/subscriptions/renew-subscriptions
Renews active subscriptions based on the provided subscription IDs.

Request Body#

FieldTypeRequiredDescription
subscriptionIdsarrayYesArray of subscription IDs to be renewed

Request

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

Example
{
    "subscriptionIds": [
        "6ZHR985PGP456XG8HCYHF919YVS6",
        "0BRBX9FGE4M77TGG14C3JYN4PMJT"
    ]
}

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 --location 'https://customers.coldmailreseller.com/api/v1/integration/subscriptions/renew-subscriptions' \
--header 'cmr-x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "subscriptionIds": [
        "6ZHR985PGP456XG8HCYHF919YVS6",
        "0BRBX9FGE4M77TGG14C3JYN4PMJT"
    ]
}'

Responses

🟢200Success
application/json
Bodyapplication/json

Examples
{
    "status": 200,
    "message": "Subscriptions added for renewal. Please ensure you have enough balance to renew the subscriptions.",
    "actionId": "ACT_7a078272-0fa7-4db4-a85b-c78697dacea1"
}
🟠422Unprocessable Entity
Modified at 2026-06-23 16:21:02
Previous
Get All Subscriptions
Next
Toggle Auto renewal
Built with