---
title: Webhook events: customer management
slug: apis/customer-management/webhook-events-customer-management
description: Receive real-time notifications for customer events like onboarding, address, phone, ID, and email updates via webhook events.
docTags: 
createdAt: 2025-04-21T10:37:44.576Z
---

## Common events

When you work with Cross River customer management, you register for specific [webhooks](docId\:qF6bTOPBPNcpLPp9SAtWI) which have a specific [event format](docId\:OIUK28uoUrZIbRmT8i7RS).

This table presents common Customer Management webhook events that are described in detail below.

| Event name                                                             | Description                                                             | Related endpoints                                          |
| ---------------------------------------------------------------------- | ----------------------------------------------------------------------- | ---------------------------------------------------------- |
| [Core.Customer.Onboarded](docId\:rl8xMrOEgISTYbmE-Y98D)                | New customer was onboarded                                              | [Add personal customer](docId\:isgkj7NIS9jHmyu3UPUBk)      |
| [Core.Customer.Address.Added](docId\:rl8xMrOEgISTYbmE-Y98D)            | Customer address was added                                              | [Add address](docId\:tWpyIp5zxe-kjEJqEUqfc)                |
| [Core.Customer.Phone.Added](docId\:rl8xMrOEgISTYbmE-Y98D)              | Customer phone number was added                                         | [Add phone](docId:5bNWSnxsqTB_GtuntlnPW)                   |
| [Core.Customer.Identification.Added](docId\:rl8xMrOEgISTYbmE-Y98D)     | Customer identification was added                                       | [Add identification](docId\:QjfGSujVfqoxCpJiqzLfF)         |
| [Core.Customer.Email.Added](docId\:rl8xMrOEgISTYbmE-Y98D)              | Customer email was added                                                | [Add email](docId\:ghuoBTAsQ0vfLcEaWXPte)                  |
| [Core.Customer.Ofac.Changed](docId\:rl8xMrOEgISTYbmE-Y98D)             | Customer OFAC status changed                                            | [Add personal customer](docId\:isgkj7NIS9jHmyu3UPUBk)      |
| [Core.Customer.PepScan.Changed](docId\:rl8xMrOEgISTYbmE-Y98D)          | Customer PEP Scan status changed                                        | [Add personal customer](docId\:isgkj7NIS9jHmyu3UPUBk)      |
| [Core.Customer.Name.Changed](docId\:rl8xMrOEgISTYbmE-Y98D)             | Name on the customer record changed                                     | [Update name](docId\:oZgr8jG6O3eBhmieFcOic)                |
| [Core.Customer.BeneficialOwner.Added](docId\:rl8xMrOEgISTYbmE-Y98D)    | Beneficial owner associated with business customer record               | [Add beneficial owner](docId\:EOH9pzYARQnyhe9mh979u)       |
| [Core.Customer.BeneficialOwner.Changed](docId\:rl8xMrOEgISTYbmE-Y98D)  | Benefical owner information changed                                     | [Update beneficial owner](docId\:kR2QhF0-bTklavDAO6GXI)    |
| [Core.Customer.BeneficialOwner.Removed](docId\:rl8xMrOEgISTYbmE-Y98D)  | Beneficial owner association with business customer removed             | [Delete beneficial owner](docId\:L5uuspwq_J-z3RKrtxZQ_)    |
| [Core.Customer.Profile.Changed](docId\:rl8xMrOEgISTYbmE-Y98D)          | Information in Profile section of the customer record updated           | [Update profile](docId:9O3Q5vAMhily1ufwtKENh)              |
| Core.Customer.DueDiligence.Changed                                     | Information in the Due Diligence section of the customer record updated | [Update due diligence info](docId\:E6pfz1-BGdTt1VFDx_prh)  |

## Event examples

### Core.Customer.Onboarded

:::CodeblockTabs
Sample Event

```curl
{
  "id": "97b574c2-08d4-42c6-884c-b2e201267681",
  "eventName": "Core.Customer.Onboarded",
  "status": "Pending",
  "partnerId": "1e5d3f04-ae24-4af6-9e30-aecf012b99dd",
  "createdAt": "2025-05-19T13:52:06.393+00:00",
  "resources": [
    "core/v1/cm/customers/61dc4d4c-3b2c-47f3-b935-b2e201266e06"
  ],
  "details": [
    {
      "customerId": "61dc4d4c-3b2c-47f3-b935-b2e201266e06",
      "clientIdentifier": "35ba6120-f860-4caa-9479-b5aaebeca49d"
    }
  ]
}
```
:::

### Core.Customer.Address.Added

:::CodeblockTabs
Sample Event

```curl
{
  "id": "6d147ea6-2628-461f-9aa6-b2e20126769e",
  "eventName": "Core.Customer.Address.Added",
  "status": "Pending",
  "partnerId": "1e5d3f04-ae24-4af6-9e30-aecf012b99dd",
  "createdAt": "2025-05-19T13:52:06.483+00:00",
  "resources": [
    "core/v1/cm/customers/61dc4d4c-3b2c-47f3-b935-b2e201266e06/addresses/e30bd094-54c9-4388-a8ca-b2e201266e0b"
  ],
  "details": [
    {
      "addressId": "e30bd094-54c9-4388-a8ca-b2e201266e0b",
      "customerId": "61dc4d4c-3b2c-47f3-b935-b2e201266e06"
    }
  ]
}
```
:::

### Core.Customer.Phone.Added

:::CodeblockTabs
Sample Event

```curl
{
  "id": "27834c98-9474-4298-bd2c-b2e20126767f",
  "eventName": "Core.Customer.Phone.Added",
  "status": "Pending",
  "partnerId": "1e5d3f04-ae24-4af6-9e30-aecf012b99dd",
  "createdAt": "2025-05-19T13:52:06.383+00:00",
  "resources": [
    "core/v1/cm/customers/61dc4d4c-3b2c-47f3-b935-b2e201266e06/phones/c46bd68a-8c07-4548-b229-b2e201266e1e"
  ],
  "details": [
    {
      "phoneId": "c46bd68a-8c07-4548-b229-b2e201266e1e",
      "customerId": "61dc4d4c-3b2c-47f3-b935-b2e201266e06"
    }
  ]
}
```
:::

### Core.Customer.Identification.Added

:::CodeblockTabs
Sample Event

```curl
{
  "id": "431a3c49-429f-4001-a1fc-b2e201267683",
  "eventName": "Core.Customer.Identification.Added",
  "status": "Pending",
  "partnerId": "1e5d3f04-ae24-4af6-9e30-aecf012b99dd",
  "createdAt": "2025-05-19T13:52:06.483+00:00",
  "resources": [
    "core/v1/cm/customers/61dc4d4c-3b2c-47f3-b935-b2e201266e06/identifications/6420d9e4-3abe-4be5-ae19-b2e201266e14"
  ],
  "details": [
    {
      "identificationId": "6420d9e4-3abe-4be5-ae19-b2e201266e14",
      "customerId": "61dc4d4c-3b2c-47f3-b935-b2e201266e06"
    }
  ]
}
```
:::

### Core.Customer.Email.Added

:::CodeblockTabs
Sample Event

```curl
{
  "id": "3d862cdc-5fc7-45c4-b40d-b2e20126769b",
  "eventName": "Core.Customer.Email.Added",
  "status": "Pending",
  "partnerId": "1e5d3f04-ae24-4af6-9e30-aecf012b99dd",
  "createdAt": "2025-05-19T13:52:06.483+00:00",
  "resources": [
    "core/v1/cm/customers/61dc4d4c-3b2c-47f3-b935-b2e201266e06/emails/7ba8f19d-f224-4e83-926e-b2e201266e0f"
  ],
  "details": [
    {
      "emailId": "7ba8f19d-f224-4e83-926e-b2e201266e0f",
      "customerId": "61dc4d4c-3b2c-47f3-b935-b2e201266e06"
    }
  ]
}
```
:::

### Core.Customer.Ofac.Changed

:::CodeblockTabs
Sample event

```curl
{
    "id": "0c4a210c-43f5-4caf-a534-b390008c415c",
    "eventName": "Core.Customer.Ofac.Changed",
    "status": "Pending",
    "partnerId": "1101a33d-fbd9-4b9e-b169-b29500f12407",
    "createdAt": "2025-11-09T03:30:39.25-05:00",
    "resources": [
        "core/v1/cm/customers/7e9e1ab8-3416-47b1-921f-b390008c30ef"
    ],
    "details": [
        {
            "customerId": "7e9e1ab8-3416-47b1-921f-b390008c30ef",
            "ofacBefore": "Pending",
            "ofacAfter": "Clear",
            "clientIdentifier": null
        }
    ]
}
```
:::

### Core.Customer.PepScan.Changed

:::CodeblockTabs
Sample event

```curl
{
    "id": "05817022-32e5-4ea2-bcdc-b390008c415c",
    "eventName": "Core.Customer.PepScan.Changed",
    "status": "Pending",
    "partnerId": "1101a33d-fbd9-4b9e-b169-b29500f12407",
    "createdAt": "2025-11-09T03:30:39.247-05:00",
    "resources": [
        "core/v1/cm/customers/7e9e1ab8-3416-47b1-921f-b390008c30ef"
    ],
    "details": [
        {
            "customerId": "7e9e1ab8-3416-47b1-921f-b390008c30ef",
            "pepScanBefore": "Pending",
            "pepScanAfter": "Clear",
            "clientIdentifier": null
        }
    ]
}
```
:::

### Core.Customer.Name.Changed

:::CodeblockTabs
Sample event

```curl
{
  "id": "54b8d91e-f439-4063-b71f-b39000927023",
  "eventName": "Core.Customer.Name.Changed",
  "status": "Pending",
  "partnerId": "1101a33d-fbd9-4b9e-b169-b29500f12407",
  "createdAt": "2025-11-09T03:53:09.877-05:00",
  "resources": [
    "core/v1/cm/customers/7e9e1ab8-3416-47b1-921f-b390008c30ef"
  ],
  "details": [
    {
      "customerId": "7e9e1ab8-3416-47b1-921f-b390008c30ef",
      "clientIdentifier": null
    }
  ]
}
```
:::

### Core.Customer.BeneficialOwner.Added

:::CodeblockTabs
Sample event

```curl
{
  "id":"7c77cc7a-a15f-4da8-8359-b3a0008ebb45",
   "eventName":"Core.Customer.BeneficialOwner.Added",
   "status":"Pending",
   "partnerId":"cd9c12f4-7691-424a-b38b-af5b0134c611",
   "createdAt":"2025-11-25T03:39:40.19-05:00",
   "resources": [
     "core/v1/cm/customers/c3f1d6e8-3bca-48e5-9249-b30400b3ab47/beneficial-owners/09aa2fdc-2d4e-443a-95b9-b3a0008eb254"
  ],
  "details": [
   {
     "ownerId":"09aa2fdc-2d4e-443a-95b9-b3a0008eb254",
     "customerId":"c3f1d6e8-3bca-48e5-9249-b30400b3ab47",
     "ownerCustomerId":"861261af-1251-49e8-966f-b2ff00d627bd"
   }
  ]
}
```
:::

### Core.Customer.BeneficialOwner.Changed

:::CodeblockTabs
Sample event

```curl
{
   "id":"f4cc3fd2-8fc5-4fec-b860-b3ae00c34426",
   "eventName":"Core.Customer.BeneficialOwner.Changed",
   "status":"Pending",
   "partnerId":"cd9c12f4-7691-424a-b38b-af5b0134c611",
   "createdAt":"2025-12-09T06:50:56.567-05:00",
   "resources": [
      "core/v1/cm/customers/b73cf966-7886-40a0-88c5-af5b0138fc8c/beneficial-owners/7c6c3667-ad62-4a7f-992e-b3ae00bbf93c"
   ],
   "details": [
   ]
 }
```
:::

### Core.Customer.BeneficialOwner.Removed

:::CodeblockTabs
Sample event

```curl
{
   "id":"9aecc9a6-1e38-4c0d-afa1-b3ae00c8e62f",
   "eventName":"Core.Customer.BeneficialOwner.Removed",
   "status":"Pending",
   "partnerId":"cd9c12f4-7691-424a-b38b-af5b0134c611",
   "createdAt":"2025-12-09T07:11:27.08-05:00",
   "resources": [
      "core/v1/cm/customers/b73cf966-7886-40a0-88c5-af5b0138fc8c/beneficial-owners/7c6c3667-ad62-4a7f-992e-b3ae00bbf93c"
   ],
   "details": [
   ]
 }
```
:::

### Core.Customer.Profile.Changed

:::CodeblockTabs
Sample event

```curl
{
  "id":"43412508-b7f4-49af-91be-b3ad009ef330",
  "eventName":"Core.Customer.Profile.Changed",
  "status":"Pending",
  "partnerId":"cd9c12f4-7691-424a-b38b-af5b0134c611",
  "createdAt":"2025-12-08T04:38:43.143-05:00",
  "resources": [
    "core/v1/cm/customers/928668cc-27ca-4388-9754-b3ad0092be45"
  ],
  "details": [
    {
       "customerId":"928668cc-27ca-4388-9754-b3ad0092be45",
       "clientIdentifier":null
    }
  ]
}
```
:::

### Core.Customer.DueDiligence.Changed

:::CodeblockTabs
Sample event

```javascript
{
    "id": "4083b6e4-7b35-414c-97fa-b47f00c7acab",
    "eventName": "Core.Customer.DueDiligence.Changed",
    "status": "Pending",
    "partnerId": "cd9c12f4-7691-424a-b38b-af5b0134c611",
    "createdAt": "2026-07-06T08:06:59.547-04:00",
    "resources": [
        "core/v1/cm/customers/53c34cf0-4cd2-4768-937b-b30000dffdca"
    ],
    "details": [
        {
            "customerId": "53c34cf0-4cd2-4768-937b-b30000dffdca",
            "clientIdentifier": "35ba6120-f860-4caa-9479-b5aaebeca49d"
        }
    ]
}
```
:::