Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.nomos.energy/llms.txt

Use this file to discover all available pages before exploring further.

Webhooks let your systems react the moment something happens at Nomos: a lead converts, a subscription activates, an invoice is finalized. Register an endpoint, subscribe to the topics you care about, and Nomos sends a signed HTTPS request as soon as the event occurs, so you can update your CRM, trigger downstream workflows, or notify your customers without polling.

Event shape

Every delivery uses the same envelope. The context carries IDs only: fetch the resource when you need its current state.
{
  "id": "evt_abc123def456ghi789jkl012",
  "timestamp": "2026-01-15T10:30:00.000Z",
  "topic": "subscription.created",
  "context": { "subscription": "sub_abc123def456ghi789jkl012" }
}

Resources

Receive webhooks

Set up an endpoint and register it in the dashboard.

Verify requests

Validate the X-Nomos-Signature header.

Retries

Handle duplicates, out-of-order events, and timeouts.

Event topics

Browse every event Nomos sends.