---
updatedAt: 2026-05-22T14:22:00.000Z
agentTools:
  projectIndex: https://developer.trulioo.com/llms.txt
---

# Event Dispatcher

<Recipe slug="event-dispatcher" title="Event dispatcher" />

<br />

<p style={{ marginLeft: "5%", marginRight: "5%" }}>To begin working with the Events API, you'll need to configure the Export API step in the builder if you haven't already. Follow these steps to set up and use the event dispatcher endpoint effectively:</p>

### 1. Setting Up the Export API Step

<p style={{ marginLeft: "5%", marginRight: "5%" }}>Configure Export API in the Builder: Navigate to your workflow builder and add the Export API step. Make sure your callback URL is correctly configured to point to your event dispatcher endpoint.</p>

### 2. Single Webhook Setup

<p style={{ marginLeft: "5%", marginRight: "5%" }}>Since your workflow will have only one callback, you need to manage any additional dispatch or routing on your server after receiving the event data.</p>

### 3. Callback URL and Event Payload

<p style={{ marginLeft: "5%", marginRight: "5%" }}>Your Callback URL will receive JSON-based payloads containing various event types. The volume of events will vary depending on the activity of users in your flow.</p>

<br />

<br />

<br />

#### **Use this link to find more information on [Receiving Events](https://developer.trulioo.com/reference/sendevent).**

<br />

#### **Example Event Payload for a Person Match Transaction**

```json Example event payload for PM transaction
{
    "id": "sample-id",
    "token": "sample-token",
    "type": "EVENT_CALLBACK",
    "event": {
        "type": "SERVICE_SUBMIT",
        "ts": 1718011363,
        "user": "sample-user-id"
    },
    "flowId": "sample-flow-id",
    "userId": "sample-user-id",
    "serviceType": "TRULIOO_EIDV",
    "test": true,
    "retry": 0,
    "serviceData": {
        "timestamp": 1718011363,
        "serviceStatus": "COMPLETED",
        "match": true,
        "transactionInfo": {
            "accountName": "sample-account-name",
            "accountIdentifier": "sample-account-identifier",
            "countryCode": "US",
            "date": "2022-11-22T12:00:00Z",
            "transactionId": "sample-transaction-id",
            "transactionRecordId": "sample-transaction-record-id",
            "userName": "sample-username"
        },
        "secondaryMatch": null
    }
}
```

<br />

#### **Example Event Payload for a DocV Transaction**

```json Example event payload for DocV transaction
{
  "id": "sample-id",
  "token": "sample-token",
  "type": "EVENT_CALLBACK",
  "event": {
    "type": "SERVICE_SUBMIT",
    "ts": 1752520263,
    "user": "sample-user-id"
  },
  "flowId": "sample-flow-id",
  "nodeId": "sample-node-id",
  "userId": "sample-user-id",
  "serviceType": "TRULIOO_DOCV",
  "test": false,
  "retry": 0,
  "serviceData": {
    "timestamp": 1752520263,
    "serviceStatus": "COMPLETED",
    "type": "DocVServiceData",
    "matchStatus": "DECLINED",
    "firstName": "COMPANY",
    "lastName": "SAMPLE",
    "fullName": "COMPANY SAMPLE",
    "documentCountryOfOrigin": "US",
    "date": "2025-07-14T19:06:56.788243797Z",
    "transactionInfo": "sample-transactionid-for-docv", 
    "personData": {
      "fullName": "COMPANY SAMPLE",
      "firstName": "COMPANY",
      "lastName": "SAMPLE",
      "middleName": null,
      "dateOfBirth": "2000-03-06",
      "address": {
        "fullAddress": "123 Fake Street",
        "city": "Vancouver",
        "stateProvince": "British Columbia",
        "country": "CA",
        "zipCode": "V1A 2B3"
      }
    },
    "matcherResults": {
      "FIRST_NAME": "NO_MATCH",
      "LAST_NAME": "NO_MATCH",
      "COUNTRY": "NO_MATCH"
    }
  }
}
```

<br />

<br />

#### **Example Event Payload for a UBO/PSC Connector Transaction**

<br />

```json Example event payload for a UBO/PSC Connector transaction
{
  "body":{
  "id": "sample-id",
  "token": "sample-token",
  "type": "EVENT_CALLBACK",
  "event": {
    "type": "STEP_SUBMIT",
    "ts": 1752520263,
    "user": "sample-user-id"
  	}
  },
  "flowId": "sample-flow-id",
  "userId": "sample-user-id",
  "test": false,
  "retry": 0,
  "formData":{
            
         },
         "pscsFormData":{
            "12345":{
               "Ownership %":[
                  "35"
               ],
               "What type of PSC is this?":[
                  "Individual"
               ],
               "Country of residence":[
                  "US"
               ],
               "First name":[
                  "Jack"
               ],
               "PSC email":[
                  "jack.jones@test.com"
               ],
               "Last name":[
                  "Jones"
               ],
               "Is the PSC Active?":[
                  "Yes"
               ]
            },
            "98765":{
               "Ownership %":[
                  "35"
               ],
               "What type of PSC is this?":[
                  "Individual"
               ],
               "Country of residence":[
                  "US"
               ],
               "First name":[
                  "Jared"
               ],
               "PSC email":[
                  "jared.smith@test.com"
               ],
               "Last name":[
                  "Smith"
               ],
               "Is the PSC Active?":[
                  "Yes"
               ]
            }
         },
         "formDataDetails":{
            
         },
         "pscsFormDataDetails":{
            "12345":{
               "sample-field-1":{
                  "label":"What type of PSC is this?",
                  "data":[
                     "Individual"
                  ],
                  "role":"owner_entity_type"
               },
               "sample-field-2":{
                  "label":"Is the PSC Active?",
                  "data":[
                     "Yes"
                  ],
                  "role":"owner_is_active"
               },
               "sample-field-3":{
                  "label":"Country of residence",
                  "data":[
                     "US"
                  ],
                  "role":"owner_address_country"
               },
               "sample-field-4":{
                  "label":"First name",
                  "data":[
                     "Jack"
                  ],
                  "role":"owner_first_name"
               },
               "sample-field-5":{
                  "label":"PSC email",
                  "data":[
                     "jack.jones@test.com"
                  ],
                  "role":"owner_email"
               },
               "sample-field-6":{
                  "label":"Last name",
                  "data":[
                     "Jones"
                  ],
                  "role":"owner_last_name"
               },
               "sample-field-7":{
                  "label":"Ownership %",
                  "data":[
                     "35"
                  ],
                  "role":"ownership"
               }
            },
            "98765":{
               "sample-field-1":{
                  "label":"What type of PSC is this?",
                  "data":[
                     "Individual"
                  ],
                  "role":"owner_entity_type"
               },
               "sample-field-2":{
                  "label":"Is the PSC Active?",
                  "data":[
                     "Yes"
                  ],
                  "role":"owner_is_active"
               },
               "sample-field-3":{
                  "label":"Country of residence",
                  "data":[
                     "US"
                  ],
                  "role":"owner_address_country"
               },
               "sample-field-4":{
                  "label":"First name",
                  "data":[
                     "Jared"
                  ],
                  "role":"owner_first_name"
               },
               "sample-field-5":{
                  "label":"PSC email",
                  "data":[
                     "jared.smith@test.com"
                  ],
                  "role":"owner_email"
               },
               "sample-field-6":{
                  "label":"Last name",
                  "data":[
                     "Smith"
                  ],
                  "role":"owner_last_name"
               },
               "sample-field-7":{
                  "label":"Ownership %",
                  "data":[
                     "35"
                  ],
                  "role":"ownership"
               }
            }
         }
},
{
      "body":{
         "id":"sample-id",
         "token":"sample-token",
         "type":"EVENT_CALLBACK",
         "event":{
            "type":"SERVICE_SUBMIT",
            "ts":1779381990,
            "user":"sample-user"
         },
         "flowId":"sample-flow",
         "userId":"sample-user-id",
         "serviceType":"SHARED_SIGNING",
         "test":false,
         "retry":0,
         "serviceData":{
            "timestamp":1779381990,
            "serviceStatus":"COMPLETED",
            "shareType":"NONE",
            "flowId":"sample-flow",
            "ownerIds":[
               "12345",
               "98765"
            ],
            "links":[
               "https://launch-workflow.trulioo.com/sample-flow?st=NjhlZTNDgwMDEyNzQ4YgozNjUwMmE0NTAwZWE1MWU4MWIxNDUxMDVkYmE5NTVlMjA3YWViMzYzZGY4YTBhNTVjNDgzM2RmYzQ2NDIxYjQ4",
               "https://launch-workflow.trulioo.com/sample-flow?st=NjhlZTMmMwMGM2ODIxZgozNDcxNDM2OWU5MmNkMzJhM2MzN2JiOWYzZjQyYWEwNGUxYWVjNjQ0ZDQzYTY5ZTIyMjc4NDAwMTE3MGIzNmQ2"
            ]
         }
      },
      "requestIp":"18.159.218.142",
      "created_at":"2026-05-21, 09:46:30"
   }

```

#### **Event Types**

<HTMLBlock>{`
<table style="width: 100%; border-collapse: collapse;">
<thead>
<tr>
  <th style="border: 1px solid #ddd; padding: 8px;"><span style= "width:300px"><strong>Event Type</strong></span></th>
  <th style="border: 1px solid #ddd; padding: 8px;"><strong>Description</strong></th>
</tr>
</thead>
<tbody>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>URL_VERIFICATION</p>
</td>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>Occurs when an API Handshake is initiated by Trulioo.<br>challenge: String sent by Trulioo, must be returned to verify the URL.<br>token: Static token sent with each transaction.</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>FLOW START</p>
</td>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>Occurs when a Workflow is initiated.<br>user, flowId, id, test, token: Various identifying and status fields.</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>STEP INIT</p>
</td>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>Occurs when a Workflow form step exists in a flow.<br>user, flowId, id, test, token: Various identifying and status fields.</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>STEP_SUBMIT</p>
</td>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>Occurs when form data is sent to Trulioo by the end user.<br>user, flowId, id, test, token, formData: Various identifying and status fields, plus submitted form data.</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>SERVICE_SUBMIT</p>
</td>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>Occurs when a service response is received by Trulioo.<br>user, flowId, id, nodeId, test, token, serviceData: Various identifying and status fields, plus service-specific data.</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>FLOW_END</p>
</td>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>Occurs when a Workflow reaches an end step.<br>user, flowId, id, test, token: Various identifying and status fields.</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>NOTE_ADDED</p>
</td>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>Occurs when a note is manually added in the Client Manager section.<br>user, flowId: Identifying fields.</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>TASK_ADDED</p>
</td>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>Occurs when a task is manually added in the Client Manager section.<br>user, flowId: Identifying fields.</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>TASK_DONE</p>
</td>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>Occurs when a task is marked complete in the Client Manager section.<br>user, flowId: Identifying fields.</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>TASK_UNDONE</p>
</td>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>Occurs when a task marked as complete is undone in the Client Manager section.  user, flowId: Identifying fields.</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>MANUALLY_ACCEPTED</p>
</td>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>Occurs when a Lead is marked as ‘Accepted’.<br>user, flowId: Identifying fields.</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>MANUALLY_PENDING_REVIEW</p>
</td>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>Occurs when a record is marked as ‘Review’.<br>user, flowId: Identifying fields.</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>MANUALLY_REJECTED</p>
</td>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>Occurs when a Lead is marked as ‘Rejected’.<br>user, flowId: Identifying fields.</p>
</td>
</tr>
</tbody>
</table>
`}</HTMLBlock>