What this endpoint does

Creates a new empty Recorded Future list. Both name and type are required. Valid type values include entity, ip, domain, vulnerability, hash, company, attacker, executive, source, and text. After creation, use the returned ID (format report:XXXXX) with Lists: Add Entity to populate the list and Lists: Get Status to check indexing progress.

Note: The API does not enforce unique list names — creating a list with the same name as an existing list will succeed and produce a separate list with its own ID.

Response data

Returns the new list's metadata — ID, name, type, creation timestamp, and ownership details. The id field is required for all subsequent list operations.