Postpone subscription

Pause an active subscription until a date you set.

POST https://cotlet.dev/api/v1/recurly/subscriptions/{subscription_id}/postpone

write Confirm

Pauses an active subscription until the renewal date you give. The postponed period is not prorated. For a subscription in a trial, changing the renewal date changes when the trial ends. It changes when the customer is next billed. By default you confirm each call; you can switch that off for this tool.

Parameters

Parameters: postpone_subscription
NameTypeDescription
subscription_id string required string Subscription UUID from list_subscriptions.
renewal_date date required date Date the subscription renews again.

Request

cURL
curl -X POST https://cotlet.dev/api/v1/recurly/subscriptions/subscription_8c41d2/postpone \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"renewal_date":"2026-10-01"}'
Python
result = client.call("recurly", "postpone_subscription", {"subscription_id":"subscription_8c41d2","renewal_date":"2026-10-01"})
Node.js
const result = await cotlet.call('recurly', 'postpone_subscription', {"subscription_id":"subscription_8c41d2","renewal_date":"2026-10-01"});
CLI
cotlet call recurly postpone_subscription --data '{"subscription_id":"subscription_8c41d2","renewal_date":"2026-10-01"}'

Example response

JSON

{
  "subscription_id": "44f83d0cbf86d2b8a5b3d3e6c3e8b16f",
  "account_code": "north-yard",
  "state": "active",
  "next_renewal_at": "2026-12-01T00:00:00Z"
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.