---
title: "Create a review for an entity watchlist screening"
method: POST
path: "/watchlist_screening/entity/review/create"
tags: ["plaid"]
---

# Create a review for an entity watchlist screening

`POST /watchlist_screening/entity/review/create`

Create a review for an entity watchlist screening. Reviews are compliance reports created by users in your organization regarding the relevance of potential hits found by Plaid.

## Request body

- WatchlistScreeningEntityReviewCreateRequest — Request input for creating a review for an entity screening
  - `confirmed_hits` EntityWatchlistScreeningHitID[], required — Hits to mark as a true positive after thorough manual review. These hits will never recur or be updated once confirmed. In most cases, confirmed hits indicate that the customer should be rejected.
  - `dismissed_hits` EntityWatchlistScreeningHitID[], required — Hits to mark as a false positive after thorough manual review. These hits will never recur or be updated once dismissed.
  - `comment` string, nullable — A comment submitted by a team member as part of reviewing a watchlist screening.
  - `client_id` string — Your Plaid API `client_id`. The `client_id` is required and may be provided either in the `PLAID-CLIENT-ID` header or as part of a request body.
  - `secret` string — Your Plaid API `secret`. The `secret` is required and may be provided either in the `PLAID-SECRET` header or as part of a request body.
  - `entity_watchlist_screening_id` string, required — ID of the associated entity screening.

## Response `200`

OK

- WatchlistScreeningEntityReviewCreateResponse — A review submitted by a team member for an entity watchlist screening. A review can be either a comment on the current screening state, actions taken against hits attached to the watchlist screening, or both.
  - `id` string, required — ID of the associated entity review.
  - `confirmed_hits` EntityWatchlistScreeningHitID[], required — Hits marked as a true positive after thorough manual review. These hits will never recur or be updated once confirmed. In most cases, confirmed hits indicate that the customer should be rejected.
  - `dismissed_hits` EntityWatchlistScreeningHitID[], required — Hits marked as a false positive after thorough manual review. These hits will never recur or be updated once dismissed.
  - `comment` string, nullable, required — A comment submitted by a team member as part of reviewing a watchlist screening.
  - `audit_trail` WatchlistScreeningAuditTrail, required — Information about the last change made to the parent object specifying what caused the change as well as when it occurred.
    - `source` 'dashboard' | 'link' | 'api' | 'system' | 'retro', required — A type indicating who or what last touched this object. `dashboard`, `link`, and `api` indicate the originating surface; `system` indicates Plaid. `retro` indicates a screening created retroactively via a bulk screening creation.
    - `dashboard_user_id` string, nullable, required — ID of the associated user. To retrieve the email address or other details of the person corresponding to this ID, use `/dashboard_user/get`.
    - `timestamp` string, date-time, required — An ISO8601 formatted timestamp.
  - `request_id` string, required — A unique identifier for the request, which can be used for troubleshooting. This identifier, like all Plaid identifiers, is case sensitive.

## Changes

- **2026-07-22** `a1bbca018160` — 1 warning
  - added the new `retro` enum value to the `audit_trail/source` response property for the response status `200`
- **2024-06-18** `be701ec93161` — 1 breaking, 1 info
  - the `comment` response property's minLength was decreased from `1` to `0` for the response status `200`
  - the `comment` request property's minLength was decreased from `1` to `0`
- **2024-02-21** `5de70cc1e6ca` — 1 breaking
  - the `comment` request property's minLength was increased from `0` to `1`

[Change history](https://skmtc.dev/plaid/apis/the-plaid-api/changes/watchlist_screening/entity/review/create/post.md)

---

[API](https://skmtc.dev/plaid/apis/the-plaid-api.md) · [All operations](https://skmtc.dev/plaid/apis/the-plaid-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/plaid/the-plaid-api/revisions/e536704a333f/schema)