Webhook Events List

Learn more about webhooks:

←MVS Home Menu

accountsDeleted

Supported APIs:

Generate V2 Connect Full

Supported processes:

VOA
VOAI
VOI
Aggregation
ACH

Description: Sent when the specified accounts were deleted for the customer.

accountsDeleted

 {

 "customerId": "1008650161",

 "eventType": "accountsDeleted",

 "eventId": "1594221522744-83455a87160c45b897058b04",

 "payload": {

   "accounts": [

     "1024371952"

   ]

 }

}

←Event List

added

Supported APIs:

Generate V2 Connect Full / Lite

Supported processes:

VOA
VOAI
VOI
Aggregation
ACH

Description: Sent after the customer lands on the eligible accounts page, and selects the accounts they want to submit for their loan. The accounts are saved in the account’s resource associated with the customer.

Note: If the institution is an OAuth connection, the oauth parameter value is true.

Ping Event

 {

  "customerId": "1017101354",

  "eventType": "added",

  "eventId": "1611877956869-28ebb24c66699bf3c77f04b1",

  "payload": {

    "accounts": [

      {

        "id": "1045121390",

        "number": "1000001111",

        "realAccountNumberLast4": "1111",

        "accountNumberDisplay": "1111",

        "name": "Checking",

        "balance": 128.52,

        "type": "checking",

        "aggregationStatusCode": 0,

        "status": "active",

        "customerId": "1017101354",

        "institutionId": "101732",

        "balanceDate": 1611877952,

        "aggregationSuccessDate": 1611877953,

        "aggregationAttemptDate": 1611877953,

        "createdDate": 1608197223,

        "lastUpdatedDate": 1611877956,

        "currency": "USD",

        "lastTransactionDate": 1611357151,

        "institutionLoginId": 1022599285,

        "detail": {

          "availableBalanceAmount": 122.12,

          "periodInterestRate": "4.5"

        },

        "displayPosition": 5

      },

      {

        "id": "1045121391",

        "number": "1000002222",

        "realAccountNumberLast4": "2222",

        "accountNumberDisplay": "2222",

        "name": "Savings",

        "balance": 128.52,

        "type": "savings",

        "aggregationStatusCode": 0,

        "status": "active",

        "customerId": "1017101354",

        "institutionId": "101732",

        "balanceDate": 1611877952,

        "aggregationSuccessDate": 1611877953,

        "aggregationAttemptDate": 1611877953,

        "createdDate": 1608197223,

        "lastUpdatedDate": 1611877956,

        "currency": "USD",

        "lastTransactionDate": 1608197228,

        "institutionLoginId": 1022599285,

        "detail": {

          "availableBalanceAmount": 1217.27,

          "periodInterestRate": "4.5"

        },

        "displayPosition": 6

      }

    ],

    "institutionId": "101732"

  }

}

←Event List

adding

Supported APIs:

Generate V2 Connect Full / Lite

Supported processes:

VOA
VOAI
VOI
Aggregation
ACH

Description: Sent when a customer enters their sign-in information at a financial institution and selects which accounts Connect can access to verify their financial information.

Note: If the institution is an OAuth connection, the oauth parameter value is true.

adding event

 {

  "customerId": "7065940",

  "eventType": "adding",

  "eventId": "1572413263805-b43cb6edb3254d4bebcfb4a0",

  "payload": {

    "institutionId": "102224",

    "oauth": true

  }

}

←Event List

credentialsUpdated

Supported APIs:

Generate V2 Connect Fix
OAuth not supported

Description: Sent when the customer updates their sign-in information for a selected institution. The mfa field indicates whether the credential challenge was followed by a sequential true or false MFA challenge question.

credentialsUpdated event

 {

  "customerId": "29272504",

  "consumerId": "41d42ef0faef200e370208ad179a44cd",

  "eventType": "credentialsUpdated",

  "eventId": "1559073542901-f2d2ebd11cf852a8114b54dc",

  "payload": {

    "institutionId": "101732",

    "mfa": false

  }

}

←Event List

discovered

Supported APIs:

Generate V2 Connect Full / Lite / Fix
OAuth not supported

Supported processes:

VOA
VOAI
VOI
Aggregation
ACH

Description: Sent after the customer has successfully signed into an institution. All of the customer’s eligible accounts to permission are included in this event. The accounts in the payload of the subsequently added event are a subset of the accounts in the discovered event. If no accounts were discovered, then an empty array is sent.

discovered event

 {

  "customerId": "29272504"

  "consumerId": "41d42ef0faef200e370208ad179a44cd"

  "eventType": "discovered",

  "eventId": "1543509870615-7db10ceac8b2f5fa9b7b078c",

  "payload": {

    "accounts": [

      "...",

      "..."

    ]

  }

}

←Event List

documentUpload

Supported APIs:

Generate V2 Connect Full/ Lite / Send Email / Fix
Connect Full – Joint Borrowers
Send Connect Email – Joint Borrowers

Supported processes:

VOIE – Paystub (with TXVerify)

Description: Sent after the user uploads a document in Connect.

documentUpload

 {

  "consumerId": "9a6f18zzz219a49d7f198a5ea6d959371",

  "customerId": "52906923",

  "eventType": "documentUpload",

  "eventId": "157652800zzz-5a1zzzzdb38df8a07915863305",

  "payload": {

    "assets": [

      {

        "assetId": "257zzzac-7712-45a6-b895-8132fc88011d",

        "label": "lastPayPeriod"

      },

      {

        "assetId": "c36zzz0f-6519-4185-aa9e-768461a7c776",

        "label": "lastPayPeriod"

      }

    ]

  }

}

←Event List

done

Supported APIs:

Generate V2 Connect Full/ Lite / Send Email / Fix
Connect Full – Joint Borrowers
Send Connect Email – Joint Borrowers

Supported processes:

VOA
VOAI
VOI
Aggregation
ACH
VOIE – Payroll
VOIE – Paystub (with TXVerify)

Description: Sent after all pending reports are completed.

Aggregation

type = aggregation

Description: The done event is sent after the customer clicks Submit at the end of a Connect experience.

done - aggregation

 {

  "customerId": "29272504",

  "consumerId": "41d42ef0faef200e370208ad179a44cd",

  "eventType": "done",

  "payload": {}

}

←Event List

done (Reports)

Supported APIs:

Generate V2 Connect Full / Lite / Send Email / Fix
Connect Full – Joint Borrowers
Send Connect Email – Joint Borrowers

Supported processes:

VOA
VOAI
VOI
Aggregation
ACH
VOIE – Payroll
VOIE – Paystub (with TXVerify)

Description: Sent after all pending reports are completed. If you request more than one report, the payload is an array of information for each report requested.

done - VOI or VOA

 {

  "customerId": "5019498180",

  "consumerId": "093e1794ca8a646ce9901edcd43160a1",

  "eventType": "done",

  "eventId": "1639513582789-f1b8ba9bc325dfbe78aa09d4",

  "payload": [

    {

      "portfolioId": "2z2ght9p54kt-1-port",

      "consumerId": "093e1794ca8a646ce9901edcd43160a1",

      "customerId": 5019498180,

      "eventName": "done",

      "id": "ue9s2g6je4j9",

      "type": "voaHistory",

      "consumerSsn": "6666",

      "status": "success"

    },

    {

      "portfolioId": "2z2ght9p54kt-3-port",

      "consumerId": "093e1794ca8a646ce9901edcd43160a1",

      "customerId": 5019498180,

      "eventName": "done",

      "id": "8tu59in6s3xy-voiepayroll",

      "type": "voiePayroll",

      "consumerSsn": "6666",

      "status": "success"

    },

    {

      "portfolioId": "2z2ght9p54kt-2-port",

      "consumerId": "093e1794ca8a646ce9901edcd43160a1",

      "customerId": 5019498180,

      "eventName": "done",

      "id": "bj0ru3yy55yz-voietxverify",

      "type": "voieTxVerify",

      "consumerSsn": "6666",

      "status": "success"

    }

  ]

}

←Event List

employerFound

Supported APIs:

Generate V2 Connect Full /Send Email
Connect Full – Joint Borrowers
Send Connect Email – Joint Borrowers

Supported processes:

VOIE – Payroll

Description: Sent when employment records matching the customer’s Social Security number (SSN) and date of birth (DOB) are found in the payroll providers.

employerFound event

 {

  "customerId": "1013916100",

  "consumerId": "06a46d02b9851829ca53946be1da8200",

  "eventType": "employerFound",

  "eventId": "1602696485261-d299df6440556091e1d0531c",

  "payload": {

    "numEmployers": 1

  }

}

←Event List

employerNotFound

Supported APIs:

Generate V2 Connect Full / Send Email
Connect Full – Joint Borrowers
Send Connect Email – Joint Borrowers

Supported processes:

VOIE – Payroll

Description: Sent when the customer’s SSN and DOB don’t match any employment records from the payroll provider.

employerNotFound event

 {

  "customerId": "1013916100",

  "consumerId": "06a46d02b9851829ca53946be1da8200",

  "eventType": "employerNotFound",

  "eventId": "1602696889157-e6adbb438604041fc39ab3dd",

  "payload": {

    "error": 404,

    "message": "Employment data not found"

  }

}

←Event List

failed

Supported APIs:

Generate V2 Connect Full / Send Email
Connect Full – Joint Borrowers
Send Connect Email – Joint Borrowers

Supported processes:

VOA
VOAI
VOI
Prequalification VOA
VOIE – Payroll
VOIE – Paystub (with TXVerify)

Description: Sent after a report has failed to generate.

failed event

 {

   "id":"reportId",

   "eventName": "failed",

   "consumerId": "conId",

   "consumerSsn": "conSSN",

   "type": "reportType",

   "status": "failure",

   "customerId": 123,

   "portfolioId": "asdf-1-port"

}

←Event List

generating

Supported APIs:

Generate V2 Connect Full / Send Email
Connect Full – Joint Borrowers
Send Connect Email – Joint Borrowers

Supported processes:

VOA
VOAI
VOI
Prequalification VOA
VOIE – Payroll
VOIE – Paystub (with TXVerify)

Description: Sent when the verification report starts generating. If you request more than one report, the payload is an array of information for each report.

generating event

 {

  "customerId": "5019498180",

  "eventType": "generating",

  "eventId": "1639513249775-192b6cf1aa025e1b5a1255c2",

  "payload": [

    {

      "id": "ue9s2g6je4j9",

      "portfolioId": "2z2ght9p54kt-1-port",

      "customerType": "testing",

      "customerId": 5019498180,

      "requestId": "35fuuudwh8",

      "requesterName": "Finicity (Layton Checketts - KEEP)",

      "createdDate": 1639513248,

      "title": "Finicity Verification of Asset and Income - Transactions",

      "consumerId": "093e1794ca8a646ce9901edcd43160a1",

      "consumerSsn": "6666",

      "constraints": {},

      "type": "voaHistory",

      "status": "inProgress",

      "reportId": "ue9s2g6je4j9"

    },

    {

      "id": "8tu59in6s3xy-voiepayroll",

      "portfolioId": "2z2ght9p54kt-3-port",

      "customerType": "testing",

      "customerId": 5019498180,

      "requestId": "zvhz6sqfs9",

      "requesterName": "Finicity",

      "createdDate": 1639513248,

      "title": "Finicity Verification of Income and Employment - Payroll",

      "consumerId": "093e1794ca8a646ce9901edcd43160a1",

      "consumerSsn": "6666",

      "constraints": {

        "payrollData": {

          "payrollDataRetrievalId": "8vwg7tm44ib1",

          "employerNames": [

            "Enterprise One"

          ]

        }

      },

      "type": "voiePayroll",

      "status": "inProgress",

      "source": "Finicity Connect",

      "reportId": "8tu59in6s3xy-voiepayroll"

    },

    {

      "id": "bj0ru3yy55yz-voietxverify",

      "portfolioId": "2z2ght9p54kt-2-port",

      "customerType": "testing",

      "customerId": 5019498180,

      "requestId": "1uv91guu71",

      "requesterName": "Finicity",

      "createdDate": 1639513248,

      "title": "Verification of Income and Employment - Paystub (with TXVerify)",

      "consumerId": "093e1794ca8a646ce9901edcd43160a1",

      "consumerSsn": "6666",

      "constraints": {

        "voieWithInterviewData": {

          "txVerifyInterview": [

            {

              "assetId": "8962b6e9-474f-4056-9151-1b5ba825a4e4-1094357070",

              "accounts": []

            }

          ],

          "extractEarnings": true,

          "extractDeductions": false,

          "extractDirectDeposit": true

        }

      },

      "type": "voieTxVerify",

      "status": "inProgress",

      "source": "Finicity Connect",

      "reportId": "bj0ru3yy55yz-voietxverify"

    }

  ]

}

←Event List

inProgress

Supported APIs:

Generate V2 Connect Full / Send Email
Connect Full – Joint Borrowers
Send Connect Email – Joint Borrowers

Supported processes:

VOA
VOAI
VOI
Prequalification VOA
VOIE – Payroll
VOIE – Paystub (with TXVerify)

Description: Sent when a report is being generated and has an inProgress status.

inProgress event

 {

   "id":"reportId",

   "eventName": "inProgress",

   "consumerId": "conId",

   "consumerSsn": "conSSN",

   "type": "reportType",

   "status": "inProgress",

   "customerId": 123,

   "portfolioId": "asdf-1-port"

}

←Event List

institutionLoginDeleted

Supported APIs:

Generate V2 Connect Full / Lite / Fix

Supported processes:

VOA
VOAI
VOI
Aggregation
ACH

Description: Sent when all of the accounts under the specified institutionLoginId were deleted for the customer.

institutionNotFound event

 {

"customerId": "1008650161",

"eventType": "institutionLoginDeleted",

"eventId": "1594221557396-19ef569f7fbfa65488283b81",

"payload": {

  "institutionLoginId": "1011648058"

 }

}

←Event List

institutionNotFound

Supported APIs:

Generate V2 Connect Full / Lite / Fix

Supported processes:

VOA
VOAI
VOI
Aggregation
ACH

Description: Sent when the user searches for an institution that is not on our list. Connect provides the description for the query field.

institutionNotFound event

 {

  "customerId": "29272504",

  "eventType": "institutionNotFound",

  "eventId": "1564677197519-4f47b664bd855275389e76c6",

  "payload": {

    "query": "not a real institution"

  }

}

←Event List

institutionNotSupported

Supported APIs:

Generate V2 Connect Full / Lite / Fix

Supported processes:

VOA
VOAI
VOI
Aggregation
ACH

Description: Sent when the user selects an institution that isn’t certified. This applies to any call except for aggregation, lite, fix, and voi-pp.

institutionNotSupported event

 {

  "customerId": "29272504",

  "consumerId": "41d42ef0faef200e370208ad179a44cd",

  "eventType": "institutionNotSupported",

  "eventId": "1543535415162-6d06cbeed93533d612b4e255",

  "payload": {

    "institutionId": "15880"

  }

}

←Event List

institutionSupported

Supported APIs:

Generate V2 Connect Full / Lite

Supported processes:

VOA
VOAI
VOI
Aggregation
ACH

Description: Sent when a user selects a financial institution from a search query that is certified for the product.

institutionSupported event

 {

  "customerId": "29272504",

  "consumerId": "41d42ef0faef200e370208ad179a44cd",

  "eventType": "institutionSupported",

  "eventId": "1557155470294-f5e5273c2354e09670647e18",

  "payload": {

    "institutionId": "101732"

  }

}

←Event List

invalidCredentials

Supported APIs:

Generate V2 Connect Full / Lite / Fix
OAuth not supported

Supported processes:

VOA
VOAI
VOI
Aggregation
ACH

Description: Sent when the user enters incorrect sign-in information for the selected institution.

invalidCredentials event

 {

  "customerId": "29272504",

  "consumerId": "41d42ef0faef200e370208ad179a44cd",

  "eventType": "invalidCredentials",

  "eventId": "1543535972345-805ba937fdc4c6d3889b261c",

  "payload": {

    "institutionId": "101732"

  }

}

←Event List

mfa

Supported APIs:

Generate V2 Connect Full / Lite
OAuth not supported

Supported processes:

VOA
VOAI
VOI
Aggregation
ACH

Description: Sent when the user enters correct sign-in information for an institution and a Multi-Factor Authorization (MFA) challenge question displays.

mfa event

 {

  "customerId": "29272504",

  "consumerId": "41d42ef0faef200e370208ad179a44cd",

  "eventType": "mfa",

  "eventId": "1543535689086-56219127a30d3f881436c0b2",

  "payload": {

    "institutionId": "101732"

  }

}

←Event List

mfaUpdated

Supported APIs:

Generate V2 Connect Fix
OAuth not supported

Supported processes:

VOA
VOAI
VOI
Aggregation
ACH

Description: Sent when the user completed the MFA challenge question for an institution.

mfaUpdated event

 {

  "customerId": "29272504",

  "eventType": "mfaUpdated",

  "eventId": "1559073793752-914b6150eacc1d59fe444bf3",

  "payload": {

    "institutionId": "101732"

  }

}

←Event List

payrollError

Supported APIs:

Generate V2 Connect Full / Send Email
Connect Full – Joint Borrowers
Send Connect Email – Joint Borrowers

Supported processes:

VOIE – Payroll

Description: Sent when an error occurs while making a request to the payroll connector service. The error code and message are included in the response payload.

Error Codes:

400: The consumer record doesn’t match the Social Security number (SSN) and date of birth (DOB) passed to Connect.
500: An unexpected error has occurred.

payrollError event

 {

  "customerId": "1013916100",

  "consumerId": "06a46d02b9851829ca53946be1da8200",

  "eventType": "payrollError”,

  "eventId": "1602696010692-ac29d9e8e1dbeee869e1b46d",

  "payload": {

    "error": 400,

    "message": "Please provide valid ssn and date of Birth for customer 1013916100"

  }

}

←Event List

payrollSearch

Supported APIs:

Generate V2 Connect Full / Send Email
Connect Full – Joint Borrowers
Send Connect Email – Joint Borrowers

Supported processes:

VOIE – Payroll

Description: Sent when the customer enters their SSN and DOB to search for their payroll information.

Ping Event

 {

  "customerId": "1013916100",

  "consumerId": "06a46d02b9851829ca53946be1da8200",

  "eventType": "payrollSearch",

  "eventId": "1602696009983-f18edc8d007efc7d4f87000e",

  "payload": {

    "ssn": "6789",

    "dateOfBirth": "1980-01-01"

  }

}

←Event List

ping

Supported APIs:

Generate V2 Connect Full / Lite / Send Email / Fix
Connect Full – Joint Borrowers
Send Connect Email – Joint Borrowers

Supported processes:

VOA
VOAI
VOI
Aggregation
ACH
VOIE – Payroll
VOIE – Paystub (with TXVerify)
VOE-Transactions
VOAI-Transactions

Description: Sent when the Generate 2.0 Connect URL APIs are called to verify that the webhook URL is accessible. This endpoint must return a 200 series or the Generate Connect URL call fails.

ping event

 {

  "eventType":ping

  "Payload": []

}

←Event List

processing

Supported APIs:

Generate V2 Connect Full / Lite / Fix

Supported processes:

VOA
VOAI
VOI
Aggregation
ACH

Descriptions: Sent when a request to generate a report is in the process of generating the report.

OAuth: Sent after the user selects their accounts from an OAuth connection, and then gets redirected back to Connect.

processing event

 {

  "customerId": "7065940",

  "eventType": "processing",

  "eventId": "1567184715231-20b2b26125f0e7ada97395cb",

  "Payload": {

    "institutionId":"102224"

  }

}

←Event List

started

Supported APIs:

Generate V2 Connect Full / Lite / Send Email / Fix
Connect Full – Joint Borrowers
Send Connect Email – Joint Borrowers

Supported processes:

VOA
VOAI
VOI
Aggregation
ACH
VOIE – Payroll
VOIE – Paystub (with TXVerify)

Description Sent when the Connect application is loaded and the landing web page is displayed.

started event

 {

  "customerId": "1013916100",

  "consumerId": "06a46d02b9851829ca53946be1da8200",

  "eventType": "started",

  "eventId": "1602695997415-9acf8c53accecf433bc8b000",

  "payload": {}

}

←Event List

unableToConnect

Supported APIs:

Generate V2 Connect Full / Lite / Send Email
Connect Full – Joint Borrowers
Send Connect Email – Joint Borrowers

Supported processes:

VOA
VOAI
VOI
Aggregation
ACH
VOIE – Payroll

Description: Sent when a financial institution is unavailable (unknown reasons) and a connection isn’t possible.

Error codes: 102, 500, 900, 903, 904, 901, 910, 915, 916, and 920.

unableToConnect Event

 {

  "customerId": "29272504",

  "consumerId": "41d42ef0faef200e370208ad179a44cd",

  "eventType": "unableToConnect",

  "eventId": "1543535415162-6d06cbeed93533d612b4e255",

  "payload": {

    "institutionId": "15880"

    "code": 500

  }

}

←Event List