Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs-v1.useautumn.com/llms.txt

Use this file to discover all available pages before exploring further.

​
February 25th 2026

​
Volume-Based Tiered Pricing

You can now choose between graduated and volume-based tiered pricing for your plans. With volume pricing, the entire usage quantity falls into a single tier instead of splitting across tiers — useful for models where the per-unit price depends on total consumption.
  • Two tier modes: Choose graduated (split across tiers) or volume (single tier applies to all units)
  • Backward compatible: Existing graduated plans work without changes; volume is opt-in via tier_behavior
  • Full stack: Supported in the plan editor, attach/checkout previews, Stripe invoices, and the API


​
Batch Attach

Attach multiple plans to a customer in a single API request. Each plan can have its own customization, feature quantities, and trial settings — all validated and applied atomically with a distributed lock.
  • One request, multiple plans: Attach several plans at once with per-plan customization
  • Preview support: Preview the combined batch before committing via /billing.preview_multi_attach
  • Concurrency safe: Distributed lock prevents conflicting concurrent attaches


​
Lazy Entitlement Resets

Entitlement resets now happen lazily on read, so customers see fresh balances instantly without waiting for a cron cycle. An atomic Postgres function and Redis Lua script prevent double-resets under concurrency.
  • Instant resets: Stale entitlements are reset the moment they’re fetched
  • Atomic & safe: Per-row locking in Postgres and atomic Redis Lua patching prevent double-resets
  • Hardened cron fallback: Batch reset cron bounded with max iterations and timeouts
  • Volume-based tiered pricing alongside graduated pricing - #765
  • Batch attach: attach multiple plans in one request - #815
  • Lazy entitlement resets for instant balance refreshes - #800, #802
  • Atomic Redis updates for customer data and entities (CRDT-safe) - #812, #813
  • Mobile navigation with sticky top bar and slide-in sidebar - #760
  • 12/24-hour date and time picker for balance reset scheduling - #760
  • Stripe coupon support in attach discount dropdown - #819
  • Metadata on Stripe invoice line items (product ID, price ID, coupon IDs) - #817
  • RPC router for Plans (create/get/update/delete) - #750
  • RPC router for Features (list/get/create/update/delete) - #762
  • Hardened reset cron with bounded batches and timeouts - #808
  • Customer filter and UI cleanups - #755
  • Unit tests GitHub Action - #801
  • Fixed scheduled switches failing when a Stripe coupon was deleted - #759
  • Fixed events table showing empty - #822
  • Fixed customer balance UI - #816
  • Fixed balance subrow to always show /granted - #779, #780
  • Fixed attach dashboard one-off products - #789
  • Fixed create customer body expand - #787
  • Fixed Vercel marketplace status not ready - #778
  • Fixed discounts on upgrades in legacy attach - #772
  • Fixed invoice without payment method - #770
  • Fixed SQS client restart - #767, #768
  • Fixed impersonation - #793
  • Fixed reset for past-due customer entitlements - #805, #806
  • Fixed zero denominator issue - #746
  • Fixed Vercel transfer request blocking - #744
  • Fixed discounts on scheduled subscriptions - #742
  • Fixed invoice cron race condition - #747
  • Fixed custom plan detection in subscription updates - #784
  • Fixed success URL handling for v2 attach checkout - #786
  • Fixed preview attach concurrency lock - #758
  • New POST /billing.multi_attach and POST /billing.preview_multi_attach for batch plan attaches - #815
  • New POST /billing.setup_payment for collecting payment methods before plan attach - #797
  • New attach/update subscription V1 params: plan_id, feature_quantities, customize, free_trial, transition_rules - #749, #752
  • RPC endpoints for Plans: /plans.create, /plans.get, /plans.update, /plans.delete - #750
  • RPC endpoints for Features: /features.list, /features.get, /features.create, /features.update, /features.delete - #762
  • Added PATCH /customers/:customer_id for partial updates - #774
  • Metadata added to Stripe invoice line items - #817
  • V2 API docs with multi-version OpenAPI specs and SDK generation pipeline - #773
​
February 16th 2026

​
Vercel Marketplace Integration

You can now use Autumn to list your products on Vercel Marketplace, letting Vercel users discover, install, and subscribe directly from their Vercel dashboard. Billing is handled automatically through Vercel’s payment infrastructure, bridged to Stripe.
  • One-click setup: Configure your Vercel Integration credentials and webhook URL from the Autumn dashboard
  • Automatic plan mapping: Your Autumn products are automatically listed as Vercel billing plans with cost formatting and entitlements
  • Per-environment filtering: Choose which products are visible in sandbox vs live environments
  • Webhook event log: Debug Vercel webhook events with a built-in Svix-powered event log


  • Onboarding guide cleanups with loading, waiting, and dismiss states - #707, #710
  • Feature picker shows “Already in plan” to prevent accidental duplicate adds - #711
  • Inline plan editor: “Add Feature” sheet correctly scoped to editor context - #717
  • Edit customer ID directly from the dashboard - #715
  • Allow adding duplicate features to plans when intentional - #683
  • Cleaned up rate limiters for better performance - #696
  • Product cache invalidation improvements - #682, #684
  • Fixed rollover credit tracking with per-rollover credit_cost and proper deductions in feature units - #736
  • Fixed irrational billing units from included usage - #728
  • Fixed timezone mismatch in frontend - #726
  • Fixed products being created unnecessarily - #731
  • Fixed update subscription custom trial handling - #738
  • Fixed legacy entity attach - #734
  • Fixed customer race condition with name - #729
  • Fixed allocated carry with unlimited - #709
  • Fixed double default product issue - #701
  • Fixed attach on dashboard respects success URL - #613
  • Fixed breakdown not showing expires_at - #688
  • Fixed charts on customer table using Tinybird - #689
  • Fixed hash idempotency key - #685, #686
  • Fixed cancel flow for free/one-off default plans - #695
  • Vercel Marketplace Billing API: plan listing, installation management, resource provisioning, and webhook handling - #741
  • Per-environment product filtering for Vercel plans - #741
​
February 2nd 2026

​
AI Pricing Editor

Edit your pricing with AI. You can now modify plans and features via chat directly from the Products page, preview grouped changes with visual diffs, and save updates with automatic versioning.
  • Chat-based editing: Toggle between list and chat view; start from your existing pricing and edit via natural language
  • Visual diffs: See exactly what changed with highlighted plans and credit schemas
  • Batch versioning: Review grouped changes (subscriptions, add-ons, one-time) and apply with one click


​
Faster Analytics via Tinybird

We’ve rebuilt our analytics infrastructure on Tinybird for significantly faster queries. You can now group usage data by customer ID or any event property, with smart handling for high-cardinality results.
  • Group by support: Slice analytics by customer ID or custom properties
  • Faster queries: Tinybird-backed aggregation and pagination for snappy dashboards
  • Smart truncation: Shows top 10 results with a toast when there are too many unique groups


  • Virtualized customer tables with @tanstack/react-virtual for fast scrolling with large datasets - #660
  • Page size selector (50/100/250/500) for customer tables - #660
  • Cancel and uncancel subscription UI with live preview and refund options - #620
  • Better Auth dashboard integration with activity tracking - #642
  • Knip CI workflow to detect unused code - #643, #644
  • Customer filters: Active/Past Due status, renamed “Products” to “Plans” - #589
  • Shared sheet overlay for plan editors with unsaved-change protection - #589
  • New customer creation flow with deterministic defaults and idempotent Stripe provisioning - #601
  • Open in Stripe added to reward dropdown - #599
  • Renamed “Plan Features” to “Features” in sidebar - #597
  • Immediate cancel option when subscription is already scheduled for cancellation - #679
  • List products cache for improved performance - #674
  • Fixed alphanumeric-only validation for discount/promo codes - #659, #660
  • Fixed prepaid allocated tracking for allocated users - #651, #652
  • Fixed consent screen overflow - #653
  • Fixed impersonation search while impersonating - #654
  • Fixed subscription update preview version handling - #650
  • Fixed admin dashboard bugs - #649
  • Fixed Alipay payment method - #640
  • Fixed sub cache multi-region issues - #638
  • Fixed migrate cancel flow - #636
  • Fixed one-time purchase race condition - #630, #631
  • Fixed Stripe canceling condition - #626
  • Fixed default trial cancellation behavior - #671
  • Fixed usage table balances display - #670
  • Fixed setup payment after trial - #668
  • Fixed Safari and Zen browser pricing agent bug - #615
  • Fixed entity-scoped customer balance display - #611, #616, #617
  • Fixed archived features appearing in selection dropdowns - #622
  • Fixed proration visibility - #618
  • Fixed table column selection bug - #672
  • Fixed rate limiting on list products - #673
  • Added billing_behavior and refund_behavior to update subscription API for deferred charges and payment method refunds - #619
  • Added cancel: null (uncancel) support to update subscription API - #614
  • Cancel V2: immediate, end_of_cycle, and uncancel modes with proper arrears billing - #628
  • Email receipts on invoice.paid when customer send_email_receipts is enabled - #637
  • Auto-void open invoices on subscription deletion (org config void_invoices_on_subscription_deletion) - #637, #643
  • Added customers.update to Autumn client SDK - #643
  • List events without requiring customer_id or feature_id filters - #594
  • Tinybird-backed POST /events/list with offset/limit pagination - #675
  • Admin API: GET /admin/oauth-clients for OAuth client metadata - #652
​
January 18th 2026

​
New Subscription Update Flow

We’ve completely rebuilt the subscription update experience. You can now update a customer’s plan directly from the dashboard with a live preview of changes, animated transitions, and proper handling of trials, add-ons, and version upgrades.
  • Live preview: See exactly what will change before confirming the update
  • Version upgrades: Update customers to specific plan versions with one click
  • Stripe discount support: Percent-off and amount-off coupons now apply correctly during updates
This endpoint will be released in our new API v2.0, which will be available in the next few weeks.

​
Pricing Agent Onboarding

Design your pricing with AI. Our new chat-based pricing builder lets you describe your pricing in plain English and watch it come to life. You can preview the results, what the checkout page will look like, then copy into your org when ready.

​
Create a Standalone Balance

Grant credits or feature access to customers without requiring them to be on a plan. Perfect for promotional credits, manual adjustments, or custom entitlements. You can set a custom expiration date for each balance you create.

Create Balance - API Reference

Other changes
  • Discord feedback dialog in sidebar for quick user feedback - #568
  • Timezone-aware analytics with proper bucket alignment for user’s local time - #567
  • Redis JSON cache for full customer data with atomic Lua deduction engine - #540
  • Split customer plans into Subscriptions and Purchases views - #588
  • Tiered pricing support added to Pricing Agent - #588
  • Products list reorganized into Recurring (Main/Add-on) vs One-off sections - #588
  • Added Vite build GitHub Action for CI type-checking - #580
  • PostHog session tracking for improved analytics - #565, #566
  • Fixed bug where you can’t disable a default product - #541
  • Fixed Redis floating point precision error causing false insufficient balance rejections - #549
  • Fixed referral redemption flow - #548
  • Fixed create customer race condition with proper duplicate handling - #560, #563
  • Fixed update add-on flow to properly remove and replace existing sub-items - #569
  • Fixed Advanced section visibility for continuous use features - #572
  • Fixed entity feature config logic for continuous use features - #571
  • Fixed trial handling for one-off and free products - #581
  • Fixed TypeScript type errors in server and tests - #579, #562
  • Fixed UI balance display bug - #555
  • Added POST /balances/create endpoint for creating standalone balances - #547, #556
  • Added GET /balances/list endpoint for listing customer balances - #547
  • Added version parameter to subscription update API for version-specific upgrades - #551
  • Stripe discounts now properly applied to line items during subscription updates - #535
  • Removed paid-only restriction on trials - any plan can now have trials - #577
​
January 12th 2026

​
Dynamic onboarding prompts

We’ve added a new in-app onboarding guide to help you get your billing set up in less than 30 minutes.
  • Docs in app: Access documentation directly within the dashboard
  • 3 prompts → full billing setup: Complete your entire billing configuration in just 3 steps
  • Dynamic code snippets: Get code snippets and prompts tailored to your specific pricing config
  • Real-time updates: See your progress update as you complete each step


  • Code cleanup and refactoring in Stripe billing plan evaluation system - #525
  • Added customerId to request context for improved tracking and observability - #520
  • Improved cache verification workflow with free product filtering and Sentry alert tags - #519
  • Major Redis Lua refactor with cache versioning, filtering, and safer updates - #512
  • Fixed multi-region cache deletion to delete from all configured regions - #539
  • Fixed import path casing issue for createProrationinvoice - #537
  • Fixed TypeScript type compatibility in BullMQ worker - #538
  • Fixed type annotations in OpenAPI definitions and RevenueCat mappings - #533, #534
  • Fixed migration logic for product downgrades and cancellations - #529
  • Fixed subscription migration to prevent auto-uncanceling during version updates - #527
  • Fixed included_usage calculation in V1.2 API backward compatibility layer - #526
  • Implemented Redis-first caching for add-to-balance operations - #524
  • Simplified Stripe webhook cache refresh strategy - #523
  • Removed redundant plan_version field from subscription API schema - #522
  • Fixed duplicate features in plan editor when closing edit feature sheet - #508
  • Added entity_id parameter support to legacy balance update endpoint - #532
  • Added /configs/push and /configs/nuke endpoints for managing organization configuration in sandbox environments - #521
  • Implemented idempotency protection for billing endpoints using idempotency-key header - #516
  • Added new POST /customers/list V2 endpoint with plan filtering, subscription status filtering, and search functionality - #518, #517
​
December 26th 2025

​
Add to balance in the dashboard

Merry Christmas! 🎄You can now add to a customer’s balance directly from the dashboard. This is useful for giving extra credits to a customer.You can input a positive or negative value in this field.

  • Balance management enhancements with atomic “Add to Balance” feature - #503
  • Product copy workflow streamlined with direct environment selection - #501
  • Plan feature sheet with discard/update actions and change detection - #499
  • Base price display logic centralized into reusable utility - #488
  • Stripe secret key authentication always available, improved UI - #491
  • Console logs removed from production builds for cleaner output - #487
  • Sign-in flow simplified by removing onboarding redirect logic - #484
  • Enter key handler added for email sign-in and cache improvements - #483
  • Plan editor UI enhanced with better pricing configuration - #481
  • Hono dependency pinned to exact version for build consistency - #494
  • UI refinements and number formatting improvements - #500
  • Add-on products no longer carry usage from main products - #502
  • Base price display component type handling fixed - #496
  • Invoice checkout cache invalidation fixed for null customer IDs - #490
  • One-off products properly handled during subscription upgrades - #489
  • Sandbox redirect logic restored for non-deployed organizations - #486
  • Dashboard checkout success URL fixed for production environments - #485
  • Transfer endpoint cache clearing URL pattern corrected - #482
  • Cache race condition in attach flow resolved with timestamp guards - #479
  • RevenueCat payment processor integration added and reverted - #497, #495, #435, #493
  • Added manual secret key override to Hono autumnHandler
  • Added checkoutSessionParams to PricingTable component from autumn-js/react
  • Added new_billing_subscription to the attach endpoint, allowing you to create a new Stripe subscription instead of combining with an existing one
​
December 24th 2025

​
RevenueCat integration

We just released a new integration with RevenueCat, to let you manage your mobile app subscriptions and billing with Autumn.This is especially helpful for users that have a mix of web and mobile users, and want to manage their billing in one place.
This is currently in beta, please reach out to us on Discord or email us at hey@useautumn.com to get access.

​
December 18th 2025

​
List and aggregate events endpoints

We just released two new endpoints to retrieve usage data that your customers have sent to Autumn.You can use this to display a billing event log, and a timeseries chart of usage data, so you can provide first-class billing observability out of the box!
​
December 16th 2025

​
Stripe customer portal link within the customer page

You can now open a customer’s Stripe customer portal directly from the customer page. You can quickly preview this and send to customers that want to manage their payment methods or see past invoices.
Stripe customer portal

​
December 10th 2025

​
Usage columns in your customer list

Preview a customer’s current credit balances straight from the customer list. Now you can see who’s worth peeking into!
Usage columns
​
December 5th 2025

​
Autumn is live in us-east

Autumn is live on US-East! Previously all requests were hitting our us-west DB.Now, we’re reading and writing from multiple Redis caches, so both checking feature balances and tracking usage events are faster and more reliable.More regions coming soon!
US-East region
​
December 1st 2025

​
Dark mode

Dark mode is here. No need to say more. We know you guys are all night owls.We also shipped an entirely new design for the plan editor and customer pages, to make managing your plans and customers easier.
Dark mode