Skip to main content
POST
Create Subscription
Base URL: https://api.nozle.app/engine/api/v1. Create a subscription directly without going through a checkout flow. Use this for server-side subscription creation where you handle payment collection separately. Auth: sk_ (secret key) only.
string
required
External customer ID. The customer must already exist: create it first with Create Customer. An unknown ID returns 404 and creates nothing.
string
required
The plan code to subscribe the customer to (e.g. pro).

Response

string
required
The subscription’s external ID, sub-<customer_id>-<plan_code>. Use it in later subscription calls.
string
required
Subscription status (e.g. active).
The response also carries Core’s full subscription object, with the plan, billing period and entitlements.

Errors

Subscription ID and repeat calls

The subscription external ID is always sub-<customer_id>-<plan_code>. Calling subscribe again with the same customer and plan returns 200 with the same subscription and creates no second one. Subscribing the same customer to a different plan creates a second active subscription next to the first; it does not replace it. Use Upgrade to change plans.