Create subscription
Create a subscription for a customer. Requires planId or planCode plus customerId. If the subscription is saved but its initial payment checkout cannot be created, the endpoint returns subscription_activation_failed; retry the same request to recover the pending subscription without creating another invoice.
2026-06-23. Send Commet-Version: 2026-06-23 with your request.Authorizations
Headers
API version used by this reference. Send this header to select this contract explicitly.
Body
1 - 2001weekly, monthly, quarterly, semiannual, yearly, one_time 0 <= x <= 90071992547409911Payment provider name or exact public payment connection ID for the initial checkout. Overrides country routing when present.
stripe, commet, dlocal Payment methods the initial checkout may offer. Restricts what the checkout already offers for the buyer's country, currency and payment connection; it never enables a method the connection does not have and never changes routing. When none of them is available to the buyer, the checkout shows that it cannot accept payments.
1card, oxxo, mercado_pago, google_pay, smartpix Billing periods of the subscription's interval paid with the first payment, including the current one. Defaults to 1. The interval does not change: each paid period renews at zero and the subscription renews normally after the last one unless cancelAtPeriodEnd is true.
1 <= x <= 60Schedules the cancellation from creation so the subscription ends after its last paid period and never renews with any payment method.