Webhook events: customer management

Common events

When you work with Cross River customer management, you register for specific webhooks which have a specific event format.

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

Event name	Description	Related endpoints
Core.Customer.Onboarded	New customer was onboarded	Add personal customer
Core.Customer.Address.Added	Customer address was added	Add address
Core.Customer.Phone.Added	Customer phone number was added	Add phone
Core.Customer.Identification.Added	Customer identification was added	Add identification
Core.Customer.Email.Added	Customer email was added	Add email
Core.Customer.Ofac.Changed	Customer OFAC status changed	Add personal customer
Core.Customer.PepScan.Changed	Customer PEP Scan status changed	Add personal customer
Core.Customer.Name.Changed	Name on the customer record changed	Update name
Core.Customer.BeneficialOwner.Added	Beneficial owner associated with business customer record	Add beneficial owner
Core.Customer.BeneficialOwner.Changed	Benefical owner information changed	Update beneficial owner
Core.Customer.BeneficialOwner.Removed	Beneficial owner association with business customer removed	Delete beneficial owner
Core.Customer.Profile.Changed	Information in Profile section of the customer record updated	Update profile
Core.Customer.DueDiligence.Changed	Information in the Due Diligence section of the customer record updated	Update due diligence info

Event examples

Core.Customer.Onboarded

{
  "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

{
  "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

{
  "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

{
  "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

{
  "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

{
    "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

{
    "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

{
  "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

{
  "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

{
   "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

{
   "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

{
  "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

{
    "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"
        }
    ]
}