Autumn Best Practices

What it does

This skill integrates with Autumn, a TypeScript-first billing SDK for managing subscriptions and usage-based pricing via Stripe. It enables AI agents to perform actions like creating or retrieving customers, generating Stripe URLs for checkout, confirming purchases, cancelling subscriptions, verifying feature access, recording usage data, and listing available products with their associated billing scenarios. The skill provides access to Autumn's core methods and configuration options.

When to use it

• Automating customer onboarding processes by creating new customer records in Autumn.
• Generating checkout links for users to subscribe or upgrade their plans.
• Tracking usage of specific features within an application to manage billing limits.
• Responding to user requests to cancel subscriptions.
• Retrieving product information and available billing scenarios (e.g., identifying if a customer is eligible for an upgrade).

Key capabilities

• customers.create: Creates or retrieves customer records.
• checkout: Generates Stripe URLs for payment processing.
• attach: Confirms purchases using cards on file.
• cancel: Cancels existing subscriptions.
• check: Verifies access to specific features based on billing status.
• track: Records usage data for billing purposes.
• products.list: Retrieves a list of products and their associated billing scenarios (new, active, scheduled, upgrade, downgrade, renew).

Example prompts

• "Create a new customer in Autumn with the ID 'user123'."
• "Generate a checkout URL for product 'pro' for customer 'user456'."
• "Track 1 unit of usage for feature 'api_calls' for customer 'customer789'."
• "List available products and their billing scenarios."

Tips & gotchas

• Requires the AUTUMN_SECRET_KEY environment variable to be set, which can be obtained from app.useautumn.com/dev?tab=api_keys.
• Always follow the "Check → Work → Track" pattern when implementing protected actions for accurate billing and usage tracking.
• Refer to docs.useautumn.com for detailed code examples and API documentation.