Create a subscription
Create a subscription for a client against one of your billing periods. The subscription starts in `pending_checkout`; send the returned `checkout_url` to the client to collect payment.
Authorization
ApiKey API key issued to the partner, sent with the Bearer prefix — for example: Authorization: Bearer sk_live_abc123.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/subscriptions/" \ -H "Content-Type: application/json" \ -d '{ "pbp_id": "string", "client": { "phone": "string", "full_name": "string", "email": "[email protected]" } }'{ "created_at": "2026-07-03T10:15:00Z", "pbp_id": "pbp_3n9k2x", "subscription_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "status": "pending_checkout", "checkout_url": "https://app.suqo.ai/pay/3fa85f64-5717-4562-b3fc-2c963f66afa6", "next_billing_cycle": "2026-08-03T00:00:00Z"}List subscriptions GET
Paginated subscriptions for your account, newest first. The status counters cover recurring subscriptions only — one-time purchases appear in `results` but are excluded from the totals.
Update a subscription's next billing cycle POST
Move a subscription's next billing date. The date must be today or later, and one-time purchases cannot be rescheduled.