Webhooks in Identity Proofing

May 27, 2026 19:55

In Identity Proofing, decision changes for a case trigger the identityProofing.statusChange event. Depending on the field that changes, the following values are included in the payload provided with the webhook:

decision
caseStatus
queue
rejectionCode
tags
assignee
verifiedFraud

Refer to the following payload example:

sidebar. Webhook payload example

{
  "inquiryId": "8V6CFF359HS5QQ6G",
  "authenticationId": "3b42bd08-9ccc-4886-bcaa-8da4ab607675",
  "apiVersion": "v1",
  "clientId": "900900",
  "eventType": "identityProofing.statusChange",
  "creationDateTime": "2022-05-24T23:13:02Z",
  "eventDateTime": "2022-05-24T23:18:00Z",
  "fieldsUpdated": [
    { "fieldName": "decision", "oldValue": "Review", "newValue": "Deny" },
    { "fieldName": "caseStatus", "oldValue": "ASSIGNED", "newValue": "CLOSED" },
  ],
  "fields": [
    "decision": "Review",
    "caseStatus": "ASSIGNED",
    "verifiedFraud": false,
    "assignee": {
      "userName": "Maqbool Ansari",
      "userId": "00u22ugh06xewQmyo0h8"
    },
    "user": {
      "userName": "Sayed Nafiz Imtiaz Ali",
      "userId": "00u276zqqm0YiI5td0h8"
    },
    "queue": "",
    "tags": [
      "Phone",
      "listAcountId",
      "addresstype",
      "velocityIP30D",
      "velocityApplicantAddress",
      "ssntag",
      "listTag",
      "channnel",
      "velocityApplicantEmail1",
      "addressValidationCode",
      "addressCity",
      "noEws",
      "velocityapplicantPhone30",
      "AddressPostalCode",
      "DeviceNoTag",
      "challengeTag",
      "validphone",
      "nameValidationCode",
      "velocitySSN",
      "income",
      "phoneValidationCode",
      "listBadPhone",
      "identityTag",
      "velocityAcountIdTag",
      "countryCodeTag"
  ]
}

Refer to the following properties table for an explanation of each property returned in the webhook payload.

sidebar. Payload properties table

JSON Path	Type	Description
inquiryId	String	A customer-supplied identifier used to track the status across the inquiry or customer journey.
authenticationId	String	UUID generated by Identity Proofing. Identifies and correlates all interactions for an authentication attempt by the end user.
apiVersion	String	The version of the API used in the webhook event.
clientId	String	The client ID used in the event. This matches the client ID for your organization provided in Kount 360.
eventType	String	A string containing the type of event that occurred.
creationDateTime	String	Date/time indicating when the order was placed.
eventDateTime	String	Date/time indicating when the event occurred.
fieldsUpdated	Array	Array of objects describing each field that changed as part of the trigger activity.
fieldName	String	Name of the field that was updated that triggered the webhook.
oldValue	String	Previous value of the changed field.
newValue	String	New value of the field.
fields	Array	Full list of current values for the relevant fields with or without changes.

Was this article helpful?

0 out of 0 found this helpful