Skip to main content
Subscribe a customer to a plan. The plan’s price, cadence and grace period are copied onto the subscription at this moment. Editing the plan afterwards never changes what this subscriber pays — see Subscriptions.

​
Request authentication

This endpoint requires a Secret Key (sk_...) passed in either the x-api-key header or as a Bearer token in the Authorization header.

​
Request parameters

​
string
required
The id of the plan to subscribe them to.
​
object
A new customer. Use this or customer_id.
​
string
An existing customer on your business. Use this or customer.
​
string
invoice or auto_debit. Defaults to whatever the plan allows.
​
integer
Overrides the plan’s trial for this subscriber only.
​
object
Any key-value data you want stored alongside the subscription.