PApaddlehq
Subscriptions

Resume a paused subscription

Changed on

Resumes a paused subscription using its ID. Only paused subscriptions can be resumed. If an active subscription has a scheduled change to pause in the future, use this operation to set or change the resume date.

You can't resume a canceled subscription.

On resume, Paddle bills for a subscription immediately by default. Subscription billing dates are recalculated based on the resume date. Use the on_resume field to change this behavior.

If successful, Paddle returns a copy of the updated subscription entity:

  • When resuming a paused subscription immediately, the subscription status is active, and billing dates are updated to reflect the resume date.
  • When scheduling a paused subscription to resume on a date in the future, the subscription status is paused, and scheduled_change.action is resume with scheduled_change.effective_at set to the scheduled resume date.
  • When changing the resume date for an active subscription that's scheduled to pause, the subscription status remains active, and scheduled_change.resume_at is updated on the existing pause scheduled change.

This operation may result in an immediate charge, so responses may take longer than usual while a payment attempt is processed.

post/subscriptions/{subscription_id}/resume

Request

  • Base URL
    https://sandbox-api.paddle.com
  • Auth
    HTTP bearer

Path parameters

subscription_idstring required

Paddle ID of the subscription entity to work with.

Request body

OR
OR
EmptyObject required

Example request

{
  "effective_from": "2024-10-12T07:20:50.52Z"
}

Response

The request has succeeded.

Changes

  • v14f35a8c6ea4dRevision changes
    • breaking

      added to the ////////// response property oneOf list for the response status

    • breaking

      added to the //////// response property oneOf list for the response status

    • info

      added the required property /// to the response with the status

  • v1e1ac347eb3c5Revision changes
    • warning

      added the new CLP enum value to the // response property for the response status

    • warning

      added the new CLP enum value to the /////// response property for the response status

    • warning

      added the new CLP enum value to the ///////// response property for the response status

    • warning

      added the new PEN enum value to the // response property for the response status

    • warning

      added the new PEN enum value to the /////// response property for the response status

    • warning

      added the new PEN enum value to the ///////// response property for the response status

    • info

      added the optional property /////// to the response with the status

    • info

      added the optional property /////// to the response with the status

    • info

      added to the / response property anyOf list for the response status

    • info

      removed from the / response property anyOf list for the response status

    • info

      added the required property / to the response with the status