What problem does it solve?
Setting up free trials involves tricky decisions: how long the trial runs, whether a card is required upfront, what happens when it ends, and how trialing an already-paying customer differs from trialing a new one. This Skill encodes the correct Autumn API patterns for each scenario so billing behavior is predictable.
Core Features & Use Cases
- Trial Configuration: Set
free_trial on attach with duration_length, duration_type (day, month, year), card_required, and on_end behavior.
- New Customer Trials: Choose between no-card trials (default, no upgrade until a card is added via the Stripe billing portal) and card-required trials using a long-lived checkout URL.
- Trials for Paying Customers: Use
on_end: "revert" to grant a plan without touching the active Stripe subscription, preserving the existing billing cycle when the trial ends.
- Trial Updates: Extend a trial by calling update_subscription with a new
free_trial (duration counts from now), or pass free_trial: null to end it immediately.
- Use Case: A sales-led team wants to give an existing paying customer 14 days of access to a higher plan. Attach the new plan with
on_end: "revert" so the customer returns to their original plan and billing cycle when the trial ends.
Quick Start
Ask the assistant to attach a plan with a 14-day free trial that requires no card and reverts to the original plan when it ends.