Subscriptions

Subscriptions are the link between a customer and a recurring price. The Subscriptions page lists every active, trialing, past-due, or cancelled subscription pulled from Stripe alongside any local-only manual grants.

Open in Dashboard

Jump directly to the matching dashboard area while you follow this guide.

Open Subscriptions

Subscriptions list

The table shows:

• customer name and email
• product and price (with billing interval)
• status: active, trialing, past_due, canceled, incomplete, etc.
• created date and current period end

Use the search box to filter by customer name or email. The status filter narrows the list to a single Stripe subscription state.

Common actions

• Sync from Stripe — pulls the latest subscription state for every customer. Run this if you’ve made changes directly in Stripe and want the dashboard to catch up. Only available when Stripe is connected (see Stripe settings — coming soon).
• Add Subscription — manually grant a customer an active subscription against a chosen price. This is symmetric with manual grants on the customer page and is intended for complimentary access, migrations, and internal testing. Manual grants are local-only today (no Stripe round-trip yet — tracked in #31).

API reference

Subscriptions can also be inspected and mutated via the admin REST API:

• GET /api/v1/admin/subscriptions — list with filters
• POST /api/v1/admin/subscriptions — create a manual grant
• POST /api/v1/admin/subscriptions/sync — trigger a sync from Stripe

See the REST API endpoints reference for full request/response shapes.