> ## 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

> Receive real-time updates from the Nomos API as signed HTTPS requests.

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.

```json theme={null}
{
  "id": "evt_abc123def456ghi789jkl012",
  "timestamp": "2026-01-15T10:30:00.000Z",
  "topic": "subscription.created",
  "context": { "subscription": "sub_abc123def456ghi789jkl012" }
}
```

## Resources

<CardGroup cols={2}>
  <Card title="Receive webhooks" icon="bolt" href="/webhooks/receiving">
    Set up an endpoint and register it in the dashboard.
  </Card>

  <Card title="Verify requests" icon="shield-check" href="/webhooks/verify-requests">
    Validate the `X-Nomos-Signature` header.
  </Card>

  <Card title="Retries" icon="arrows-rotate" href="/webhooks/retries">
    Handle duplicates, out-of-order events, and timeouts.
  </Card>

  <Card title="Event topics" icon="list" href="/webhooks/events/subscription-created">
    Browse every event Nomos sends.
  </Card>
</CardGroup>