> ## Documentation Index
> Fetch the complete documentation index at: https://lifters.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhooks

> Receive real-time notifications from Atlas when significant events occur in your data pipeline.

<Warning>
  Webhooks are currently in development and not yet available. This page documents the planned
  specification. [Join the waitlist](https://app.atlas.io/waitlist/webhooks) to be notified.
</Warning>

## Overview

Webhooks allow Atlas to **push notifications** to your system when something significant happens — instead of you polling the API.

## Planned Event Types

| Webhook Event               | Description                                             |
| --------------------------- | ------------------------------------------------------- |
| `risk.threshold.exceeded`   | A player's risk score exceeds your configured threshold |
| `aml.alert.created`         | An AML/PLD alert was triggered for a player             |
| `player.self_excluded`      | A player activated self-exclusion                       |
| `brand.data.anomaly`        | Unusual data pattern detected (e.g., RTP deviation)     |
| `transaction.fraud.flagged` | A transaction was flagged by the fraud engine           |

## Planned Signature Verification

All webhook payloads will include an `X-Atlas-Signature` header for verification:

```javascript theme={null}
const crypto = require('crypto');

function verifyWebhook(payload, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(payload)
    .digest('hex');
  return `sha256=${expected}` === signature;
}
```

## Subscribe to Updates

* [status.atlas.io](https://status.atlas.io) — Platform status
* [changelog](/introduction/changelog) — Feature releases

Contact [platform@atlas.io](mailto:platform@atlas.io) to be added to the webhooks beta.
