2. Creating an Entity

Entities are the basing building block for Transaction Monitoring.

Entities are either businesses or users such as:

  • User Name: Sarah Smith
  • User ID: 9547-sngfB
  • Business Name: JHK Corp
  • Business ID automatically created by your company: ja-945Jgd92N

Create a Sample Entity:

Typically, an engineer from your company will automatically create entities for you using our APIs and sending data to our system. Let's go ahead and create one ourselves using the manual upload option:

  1. Log into your Dashboard.
  2. Navigate to the Data Explorer:
  1. Go to the Upload File tab:
  1. Download this JSON file on your computer.
     "user_data": {
          "first_name": "Larry",
          "last_name": "Baker",
          "gender": "male",
          "year_of_birth": 1962,
          "month_of_birth": 5,
          "day_of_birth": 21
     "general_data": {
          "entity_id": "Baker01",
          "entity_type": "user"



At this time we highly encourage you to change the name and ID of the user to create something unique.

There is an icon if you hover over the window that can be used to copy the text. You can also highlight the text and copy-paste it into a text editor like Notepad. Save the file as Create_entity_baker01.json and make sure no extra text is added and that the file extension is JSON and not TXT.


This JSON file will create an entity that is a user called Larry Baker with the Entity ID Baker01.

Unit21 also assigns a numeric ID (seen in the URL) called the Unit21 ID, in this example, it is: 719170349.


What is a JSON file?

JSON is a standard data interchange format that uses human-readable text to store and transmit data objects consisting of attribute–value pairs and arrays such as our "entity" object.

This is the format your engineers or IT team will use to send data to Unit21.

  1. Drag and drop the Create_entity_baker01.json file to the Upload File widget.
  2. Make sure the file uploaded correctly, it should be labeled as Awaiting Trigger:
  1. In the table of Recent Uploads, select the ... menu item (three dots on the right hand side) of your Create_entity_baker01.json file:
  1. Select Process in the menu:

Unit21 will process the file and add the Baker entity to our system.

The Process & Execute rules option is for uploaded files that can also run workflows such as identity verification.

  1. Patiently wait while Unit21 validates and processes the file.
  2. Refresh the page until you see Process Success under the status of the file:


My Validation Failed!

If your file upload failed, it means that the text in the JSON file was corrupted. Try to copy it again and make sure nothing is deleted or added.

You can use this online tool to check the validity of the JSON file: https://jsonlint.com/

  1. Success! Now let's see the results by navigating to the Entities tab:


I don't see my Entity!

If you don't see Baker in the entity list, you may need to reset the search filters. You also need to make sure you have the right permissions.

  1. You can click on the Baker entity in the table to view more information:

Click on the Go to Detail Page -> to learn more about Larry Baker:


Once there is more data on your Dashboard, you can use the menu items to view transactions and instruments related to your entity.

You can also look at more entity details that may be populated in the future, such as the entity status or risk score.

Next, we will see how you can search for your new entity in the system.