Skip to main content
POST
Create a local subscription record
This endpoint requires authentication. Include your Bearer token in the Authorization header.

Description

POST /billing/subscriptions Creates a TenantSubscription for the resolved lookupKey plan, blocking if the tenant already has an active subscription (returns 409 with a Customer Portal URL) or has unpaid Stripe invoices (returns 402 with a Customer Portal URL to settle them). Authorization:
  • Required role: owner only

Code Examples

Authorizations

Authorization
string
header
required

JWT Authorization header using the Bearer scheme. Format: "Bearer {token}"

Body

application/json
lookupKey
string
required
Example:

"plus_monthly"

Response

Subscription created

status
string
Example:

"success"

message
string
data
object

Local mirror of a tenant's subscription (TenantSubscription model).