v1

latestOpenAPI 3.1.02026-08-042453938.9 KB
Subscriptions

Create a subscription

Create a recurring billing subscription for a customer.

post/v1/subscriptions

Request body

customerIdstring required

Customer ID

namestring required

Subscription name

descriptionstring

Optional description

interval'DAILY' | 'WEEKLY' | 'MONTHLY' | 'ANNUAL' required

Billing interval

priceUsdcnumber required

Price per interval in USDC

metadataobject

Custom metadata

trialDaysinteger

Trial period in days (1-365)

includedUsageinteger

Included usage units per period

overageUnitTypestring

Usage type for overage metering

Response

Subscription created

object required

Subscription created