Skip to main content

Create a Stripe subscription for the organization's customer

POST 
/stripe/subscriptions

Creates a Stripe Subscription for the supplied customerId against one or more prices, tagging it with metadata.organization_id. Requires the manageBilling ability.

NOTE ON BODY SHAPE: the platform validator (subscription_creation) expects { customerId, items: [{ priceId, discounts? }], allowDoubleSubscriptions? }. The LDS client (lib/platform/client.ts createStripeSubscription) currently sends the flattened { customerId, priceId }. Both forms are documented below — items[] is the platform-authoritative shape; the flat priceId is shown as the LDS convenience form. When allowDoubleSubscriptions is false, the platform rejects a price already present on an active subscription (STRIPE_DUPLICATE_SUBSCRIPTION_ITEM).

Request​

Responses​

The created Stripe subscription.