Skip to main content
POST
Add items to list

Overview

Adds one or more items to a specific list identified by UUID. Requires permission to update the list.

Endpoint

Authentication

Request Body

array
required
Each element:
  • primaryValue (string, required)
  • searchKeys (string[], optional)
  • category (string, optional)
  • riskScore (number, optional)
  • itemData (object, optional)
  • metadata (object, optional)
object
  • batchSize (number, optional)
  • ignoreDuplicates (boolean, optional)
  • updateExisting (boolean, optional)

Notes

  • For large uploads with richer per-row fields, prefer Bulk import items (POST /data-lists/{id}/items/bulk).
  • Shortcut POST /data-lists/{type}/items adds to the first active list of that type (oldest by default). Prefer list id when you have multiple lists per type.

Response

201 with counts (processed, errors, duplicates, etc.) on success.