Manage Custom Watchlists

The Custom Watchlists page lets you maintain your own blocklists and allowlists of individuals, independent of Incode's built-in fraud lists. Use it to review existing entries, add new ones, and control how each entry affects future sessions.

This page uses two related terms:

• Entity: The real-world person or business a watchlist record represents (their name, ID numbers, contact details, and so on).
• Entry: A single row in the table. One entity can have more than one entry: for example, if they were added to the watchlist more than once, or through different sessions.

The table on Custom Watchlists can show the following columns.

On this page, you can:

• Filter the Custom Watchlists that are shown
• Manually add a single watchlist entity
• Bulk upload watchlist entries
• Edit watchlist entries
• Export Custom Watchlists to a CSV file
• Configure your view of the Custom Watchlists table
• Delete watchlist entries

Filter Custom Watchlists

1. In the left menu, click Custom Watchlists.
2. Click Add Filter in the top left.
3. Select the column you want to filter by:
   • Name: Enter the entity name you want to search for.
   • Watchlist ID: Enter the unique identifier for the entry you want to search for.
   • Created At: Select a start and end date from the calendar to only show Custom Watchlists created in that range.
   • Updated At: Select a start and end date from the calendar to only show Custom Watchlists modified in that range.
   • Phone: Enter the phone number for the entity you want to search for.
   • Device Hash: Enter the device hash for the entry you want to search for.
   • Email: Enter the email address for the entity you want to search for.
   • Watchlist Type: Select Blocklist or Allowlist.
   • ID Number: Enter the government-issued ID number for the entity you want to search for.
   • Birthdate: Select a date from the calendar.
   • Expires: Select a date from the calendar.
4. Click Apply. The table displays the Custom Watchlists that fit your criteria.
5. Repeat these steps to add additional filters.

Add Watchlist Entities

You can manually add a single entity to a watchlist.

1. In the left menu, click Custom Watchlists.
2. Click the three-dot menu (⋮) in the top right.
3. Select Add to Watchlist. The Add Entity to Watchlist dialog opens.
4. Optionally upload a photo, front ID image, and back ID image (JPG, JPEG, or PNG, up to 10 MB each).
5. Enter the entity's details: Name, Birth Date, ID Number, Personal ID Number, Email, and Phone Number. You must include at least a Name or ID Number. {/* PM: True that only a Name or ID Number is required? */}
6. Choose the Watchlist type (Blocklist or Allowlist) and, optionally, a Watchlist Expiry date.
7. Click Add to Watchlist.

Upload Watchlist Entries

Add multiple entities at once via CSV import. Bulk upload only adds entity data; you must then add photos manually by editing each entry.

1. In the left menu, click Custom Watchlists.
2. Click the three-dot menu (⋮) in the top right.
3. Select Upload Watchlist. The Upload Watchlist File dialog opens.
4. If needed, click Download template CSV to get the correct file format.
5. Drag and drop your CSV file or click to browse and select it.
6. Click Add to Watchlist.

Other Ways to Add Entities

In addition to the manual and bulk methods above, entities can be added to a Custom Watchlist through:

• Single Session view: Add a user directly from the Risk tab in single Session view. This pulls the relevant information from the Session and creates a Custom Watchlist entry automatically.
• Automatic addition: Enable Automatically add suspected fraud in the Custom Watchlist module to have suspected fraudulent sessions added as entries without manual action.

Edit Watchlist Entries

1. In the left menu, click Custom Watchlists.
2. Click the pencil icon in the Actions column for the entry you want to edit.
3. In the Edit Watchlist Entity dialog, update any field: Name, Birth Date, ID Number, Personal ID Number, Email, Phone Number, Watchlist, and Watchlist Expiry.
4. Click Edit Entity to save.

Export Custom Watchlists

1. In the left menu, click Custom Watchlists.
2. Click the three-dot menu (⋮) in the top right.
3. Select Export to CSV to download the current table data. Download starts immediately; no dialog appears.

Configure Custom Watchlists View

You can show, hide, and reorder columns in the Custom Watchlists table. This change only affects your account. Other users still see their own view.

1. In the left menu, click Custom Watchlists.
2. Click the three-dot menu (⋮) in the top right.
3. Select Table Settings.
4. In the Configure Table View panel:
   • Click the eye icon next to a column to show or hide it.
   • Drag a column by its handle (⋮⋮) to reorder it.
5. Click Save View to apply your changes. This view of the page is shown on future visits, even after logging out.

Delete Watchlist Entries

Deletion happens immediately with no confirmation dialog, and it cannot be undone.

1. In the left menu, click Custom Watchlists.
2. Click the trash can icon in the Actions column for the entry you want to delete.