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 The access token is valid for 60 minutes. Cache it; when it expires,
refresh it instead of
asking for a new one.
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: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.
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.