Skip to main content

Integration Paths

Hosted Components

Send customers to a branded, Nomos-hosted checkout and customer portal. No frontend code required.

Build your own

Quote pricing, collect customer info, and create a subscription against the API end-to-end.

Make your first authenticated request

1

Get an access token

The Nomos API uses OAuth 2.0. This quickstart uses the client credentials grant for server-to-server requests; for third-party integrations acting on behalf of a customer, see Authentication.Create a client_id and client_secret in the Nomos dashboard. If you don’t have dashboard access yet, ask your dedicated Nomos contact.Exchange your credentials for a short-lived access token:
The access token is valid for 60 minutes. Cache it; when it expires, refresh it instead of asking for a new one.
2

Make a request

List the plans configured on your organization. This proves your token works.
If you see an UNAUTHORIZED error, your token is missing, malformed, or expired. See Errors.

Test in the sandbox

The sandbox is a separate copy of Nomos for building your integration. It has its own data, so credentials, plan IDs, leads, and webhook endpoints created there don’t exist in production, and you create them again when you go live.
The sandbox sends real webhooks and real customer emails, in your branding. Sign up only with email addresses you control.
No grid operator or previous supplier is involved, so the sandbox moves new subscriptions forward on its own: about five minutes after signup it confirms the subscription with today as the start date, and about five minutes later it activates it. Each step sends the same webhooks and emails as in production. To send any other subscription.* event, open the subscription’s row actions on the customers page of the sandbox dashboard and choose Status ändern. These test events go to every active endpoint once, without retries.