---
title: "Configure webhooks for risk signals"
description: "Learn how to set up and test webhooks for risk signals in your platform."
url: "https://docs.adyen.com/marketplaces/identify-account-holder-risk/configure-webhooks-for-risk-signals"
source_url: "https://docs.adyen.com/marketplaces/identify-account-holder-risk/configure-webhooks-for-risk-signals.md"
canonical: "https://docs.adyen.com/marketplaces/identify-account-holder-risk/configure-webhooks-for-risk-signals"
last_modified: "2022-07-27T14:04:00+02:00"
language: "en"
---

# Configure webhooks for risk signals

Learn how to set up and test webhooks for risk signals in your platform.

When a new risk signal triggers for an account holder, Adyen can send webhooks to your server. If you want to get notified of these events, you can subscribe to the webhook.

To keep track of risk signal-related events in your marketplace, make sure that:

* Your server can [receive and accept webhooks](/development-resources/webhooks/configure-and-manage).
* You subscribed to the **Configuration webhooks** in your [Customer Area](https://ca-test.adyen.com/).

After you have completed your setup, reach out to your Adyen contact, so we can enable sending the [webhook type](/marketplaces/webhook-types) `balancePlatform.score.triggered`.

## Example webhook

The following is an example request body for a configuration webhook of the type `balancePlatform.score.triggered`.

In the example, the risk signals listed in the `scoreSignalsTriggered` array triggered the webhook to be sent.\
The value of the `data.id` field represents an ID that is connected to this specific score calculation. This ID changes for every score calculation and recalculation, and does not appear in your Customer Area.

**Example webhook**

```json
{
  "data": {
    "balancePlatform": "YOUR_BALANCE_PLATFORM",
    "creationDate": "2023-03-16T13:58:31+01:00",
    "id": "V4HZ4RBFJGXXGN82",
    "accountHolder": {
      "reference": "YOUR_ACCOUNT_HOLDER_REFERENCE",
      "description": "S.Hopper - Staff 123",
      "id": "AH00000000000000000000001"
    },
    "accountHolderStatus":"Active",
    "automatedActions":["bumpKYCTier"],
    "riskScore": 47,
    "scoreSignalsTriggered": [
      "DistinctAddressUsage",
      "HighNumberOfLegalEntitiesInIdentity",
      "HighNumberOfAccountsInIdentity",
      "AccountAge",
      "LEMCountry"
    ],
    "signalSourceTypes":["LegalEntityEmailReferral"]
  },
  "environment": "test",
  "timestamp": "2023-03-16T13:58:31+01:00",
  "type": "balancePlatform.score.triggered"
}
```

## See also

* [Set up webhooks](/development-resources/webhooks/configure-and-manage)