Skip to main content
Nozle provides two complementary HTTP API surfaces: The complete Core API reference is generated from Nozle’s OpenAPI contract. Nozle-specific workflow endpoints are documented alongside it.

Typical integration

  1. Create or update a customer using your application’s stable external identifier.
  2. Define typed Features and plans in the dashboard or Core API.
  3. Create a subscription or start a payment-gated checkout.
  4. Send idempotent usage events from your backend.
  5. Process signed webhooks and reconcile subscription, invoice, and payment state.

Authentication

Server endpoints require a secret key in the Bearer authorization header:
Publishable keys are limited to the public plan catalog. Never expose a secret key in browser or mobile code. See Authentication for the full trust-boundary model.

Identifiers

Use external_id, external_customer_id, and external_subscription_id for identifiers owned by your application. Treat Nozle-generated UUIDs as opaque values and preserve exact compatibility field names shown in each endpoint schema.

Next steps