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

# Configure notifications for risk signals

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

[View source](/classic-platforms/identify-account-holder-risk/configure-notifications-for-risk-signals.md)

This page is for classic Adyen for Platforms integrations. If you are just starting your implementation, refer to our [new integration guide](/adyen-for-platforms-model) instead.

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.

This works the same way as adding other [webhooks](/classic-platforms/configure-notifications). The event type for risk signals is `SCORE_SIGNAL_TRIGGERED`.

You can add a [new notification configuration](#create-a-notification-configuration), or you can [update your existing configuration](#update-notification-configurations).

After you have completed your setup, notify us so that we can turn on the webhook notification.

## Create a notification configuration

Make a POST [/createNotificationConfiguration](https://docs.adyen.com/api-explorer/NotificationConfiguration/latest/post/createNotificationConfiguration) call, passing the URL where the notifications should be sent, and the notification type.

**Create notification configuration**

```bash
curl https://cal-test.adyen.com/cal/services/Notification/v6/createNotificationConfiguration \
-H 'x-API-key: YOUR_X-API-KEY' \
-H 'content-type: application/json' \
-d '{
  "configurationDetails":{
  	"active": false,
    "eventConfigs":[
      {
        "eventType":"SCORE_SIGNAL_TRIGGERED",
        "includeMode":"INCLUDE"
      }
    ],
    "notifyURL":"https://www.merchant-domain.com/notification-handler"
  }
}'
```

**Response**

```json
{
    "pspReference": "XB7XNCQ8HXSKGK82",
    "configurationDetails": {
        "active": true,
        "eventConfigs": [
            {
                "eventType": "SCORE_SIGNAL_TRIGGERED",
                "includeMode": "INCLUDE"
            }
        ],
        "notificationId": 12345,
        "notifyURL": "https://www.merchant-domain.com/notification-handler",
    }
}
```

## Update a notification configuration

If you have already have an existing notification configuration, you can update your notification setup.

Make a POST [/updateNotificationConfiguration](https://docs.adyen.com/api-explorer/NotificationConfiguration/latest/post/updateNotificationConfiguration) call and pass the new setting as its parameters. The notification to be updated is specified by the `notificationId` value.

**Update a notification configuration**

```bash
curl https://cal-test.adyen.com/cal/services/Notification/v6/updateNotificationConfiguration \
-H 'x-API-key: YOUR_X-API-KEY' \
-H 'content-type: application/json' \
-d '{
   "configurationDetails":{
      "active":false,
      "eventConfigs":[
         {
            "eventType":"ACCOUNT_CREATED",
            "includeMode":"INCLUDE"
         },
         {
           "eventType":"SCORE_SIGNAL_TRIGGERED",
           "includeMode":"INCLUDE"
         }
      ],
      "notificationId":12345,
      "notifyURL":"https://www.merchant-domain.com/notification-handler"
   }
}'
```

**Response**

```json
{
   "pspReference":"R5CZ2NWPJTGV9D82",
   "configurationDetails":{
      "active":false,
      "eventConfigs":[
         {
               "eventType":"ACCOUNT_CREATED",
               "includeMode":"INCLUDE"
         },
         {
               "eventType":"SCORE_SIGNAL_TRIGGERED",
               "includeMode":"INCLUDE"
         }
      ],
      "notificationId":12345,
      "notifyURL":"https://www.merchant-domain.com/notification-handler",
   }
}
```

## Example notification

The following is an example notification body for the `SCORE_SIGNAL_TRIGGERED` event type, triggered by the `EmailSyntaxCheck` risk signal.

**Example notification**

```json
{
  "eventDate": "2022-04-05T13:29:15+02:00",
  "eventType": "SCORE_SIGNAL_TRIGGERED",
  "executingUserKey": "IdentityRisk",
  "live": "false",
  "mimeType": "genericNotification",
  "pspReference": "JDD6LKT8MBLZNN84",
  "content": {
      "accountHolderCode": "YOUR_ACCOUNT_HOLDER_CODE",
      "riskScore": 80,
      "scoreSignalsTriggered": [
        "EmailSyntaxCheck"]
      }
}
```
