Skip to main content
POST
This endpoint creates a new subscription for recurring billing. Subscriptions automatically generate invoices and process payments based on the billing cycle.

Authentication

This endpoint requires a valid API key with subscriptions:write permissions.

Request Body

string
required
Customer ID for the subscription
string
required
Subscription plan ID
string
required
Subscription start date (ISO 8601)
string
required
Default payment method for automatic billing
integer
Number of subscriptions (default: 1)
string
Trial period end date (ISO 8601)
string
Date to anchor billing cycles (ISO 8601)
array
Additional subscription items
string
Coupon to apply to subscription
object
Shipping address for physical subscriptions
object
Additional custom fields

Response

Returns the created subscription.