Duplicate search upon API insert

Last published at: April 22nd, 2025

Duplicate records can be found in several ways using Plauti Deduplicate. One way is by automatically checking for duplicates against all entity records in the database when you insert records via API. 

Prerequisites

  • Searching for duplicates upon insert via API should be enabled in the Feature Activation & Setup settings of the entity you are inserting. Make sure the Enable duplicate detection for API Inserts by logging to Duplicate Check job setting is configured and activated. Read more in Duplicate Prevention‍.

Checking for duplicates upon inserting via API

When you insert records via API, Plauti Deduplicate will scan the entity's other records to see if there are any records that match the records that were just inserted. The fields you set in the scenario(s)‍ are compared, and if they match close enough the records are logged as a duplicate set in a dedicated Duplicate Check job.

  • A Duplicate Check job is created per entity, as soon as the first duplicate is detected via API insert. More detected duplicates are added to their entity's job.
  • Just like with other DC jobs, you can review and process the duplicates via “View Results”. When all duplicates have been processed, the View Results button will turn grey and cannot be clicked anymore, until new API insert duplicates come in.
  • If you happen to delete an API duplicates job, a new one is created automatically at the detection of the next duplicate via API insert for that entity.

Reviewing API insert duplicates

After you have inserted records via API:

  1. In the Plauti Deduplicate app, at left, click Duplicate Check Job .
    The Duplicate Check Jobs overview opens.
  2. Find the API Duplicate Check job for the entity where you just inserted records via API. It's called “Duplicates detected via API” followed by the Entity label. 
    The API Duplicate Check job for the entity that has had records inserted via API most recently is shown at the top of the jobs list.

  3. Click the chevron icon to view a summary of the job information. 
    At “Finished At:", the date and time is shown of when the last duplicate, inserted via API, was detected for this entity.
  4. Click Job Options for more job options, such as Auto Merge
    Read more in DC Jobs Overview.
  5. Click View Results to review the duplicate records, and process them (e.g. merge or discard one or more duplicates). 
    Read more in DC Job Results Overview.

    Configure Result Fields for API insert job results in Feature Activation & Setup

    The result fields you see in the DC Job Results Overview of an API insert duplicate job can be configured in the Result Fields‍ setting in the “Enable duplicate detection for API inserts” section of Feature Activation & Setup for the entity (the result fields of other Duplicate Check jobs are configured in the “Result Fields - Duplicate Check Job Results” setting of the <Entity> Settings).

     

 

Only active duplicate records are shown

Plauti Deduplicate will search all records to find duplicates, but will only display active records as result. Duplicate records that are disabled will not be shown.
What is considered an active or disabled record can differ per organization. In the Entity Settings‍ you can indicate which records should be regarded as disabled or active for the duplicate search results.