Create an entity

Creates a new entity, sending entity data in the request body.

If the /entities/create API is called for an entity that already exists in our system, it is treated it as an upsert and an update on the existing entity is performed. The response to the request will then contain the entry previously_existed: true.

Unit21 selectively ignores upserts if the request is identical to a previous request. The response to any ignored upsert will contain the field ignored: true.

If you want to perform strict validation and not perform an upsert on conflict, specifying options.upsert_on_conflict: false will result in the API responding with a 409 error code indicating that this entity cannot be overwritten.

Updates to an entity's general_data.entity_id are not allowed.

Instruments can be associated with entities by providing the IDs of these instruments within the instrument_ids section of the request. If the instrument doesn't already exist, Unit21 creates a placeholder instrument.

Whitelisted entities cannot be updated through the /entities/create endpoint.

We recommend that you create entities prior to running verification. In the event you wish to run a verification on an entity immediately, Unit21 recommends that you wait at-least 2 minutes for your entity data to be fully processed. You will receive a 423 error code if an entity is busy. When a 200 response is received, the data has been successfully stored on the Unit21 backend; however, it may take a few additional seconds to process that data so that it becomes available in subsequent API calls, in the frontend UI, and/or for verification purposes.

Follow the links for more information:

Click Try It! to start a request and see the response here!