Paddle Billing
Search

Activate a trialing subscription in one API call

Use the activate a trialing subscription operation to immediately activate a trialing subscription.

What's new?

We added the activate a trialing subscription operation to the Paddle API. You can use it to immediately activate a subscription that's in trial.

POSThttps://api.paddle.com/subscriptions/{subscription_id}/activate
subscription_idstring

Paddle ID of the subscription entity to work with.

The activate a trialing subscription operation works for subscriptions where the status is trialing. You cannot reinstate a canceled subscription.

How it works

Making it as easy as possible for trialing customers to transition to a paid plan is a simple way to reduce your customer acquisition cost.

You can use the new activate a trialing subscription operation to bill for a subscription that's trialing, cutting any remaining trial period short. There's no need to include a date with your request — the subscription is activated immediately.

We recommend providing a way for customers to make changes to their subscription, like adding or removing users or changing their plan, before activating a subscription.

To preview charges and present them to a customer, get a subscription including the next_transaction and recurring_transaction_details objects.

Next steps

This change is available in version 1 of the Paddle API.

It's a non-breaking change, meaning it doesn't impact existing integrations.

You can activate a trialing subscription using the API to get started.

Learn more