---
title: "POST /list/create"
method: POST
path: "/list/create"
tags: ["List"]
---

# POST /list/create

`POST /list/create`

## Request

- Base URL: `https://api.recordedfuture.com`
- URL: `https://api.recordedfuture.com/list/create`
- Auth: one of:
  - API key in header `X-RFToken`
  - OAuth 2
    - Authorization code: `https://id.recordedfuture.com/authorize`
    - Token URL: `https://id.recordedfuture.com/token`

Creates a new empty list and returns its metadata including the list ID.

## Request body

- CreateRequest
  - `name` string, required
  - `type` 'entity' | 'source' | 'text' | 'custom' | 'ip' | 'domain' | 'tech_stack' | 'industry' | 'brand' | 'partner' | 'industry_peer' | 'location' | 'supplier' | 'vulnerability' | 'company' | 'hash' | 'operation' | 'attacker' | 'target' | 'method' | 'executive', required

## Response `200`

Success

- ListInfo
  - `id` string, required
  - `name` string, required
  - `type` 'entity' | 'source' | 'text' | 'custom' | 'ip' | 'domain' | 'tech_stack' | 'industry' | 'brand' | 'partner' | 'industry_peer' | 'location' | 'supplier' | 'vulnerability' | 'company' | 'hash' | 'operation' | 'attacker' | 'target' | 'method' | 'executive', required
  - `created` string, date-time, required
  - `updated` string, date-time, required
  - `owner_id` string: Id of the Owner
  - `owner_name` string: Name of the Owner
  - `organisation_id` string: Id of the Organisation
  - `organisation_name` string: Name of the Organisation
  - `owner_organisation_details` OwnerOrganisationDetails
    - `owner_id` string: Id of the Owner
    - `owner_name` string: Name of the Owner
    - `organisations` Organisation[], required
      - `organisation_id` string: Id of the Organisation
      - `organisation_name` string: Name of the Organisation
    - `enterprise_id` string, required: Id of the Enterprise
    - `enterprise_name` string, required: Name of the Enterprise

## Other responses

- `400`: Invalid format or missing required parameters

---

[API](https://skmtc.dev/recordedfuture/apis/list-api.md) - [All operations](https://skmtc.dev/recordedfuture/apis/list-api/llms.txt) - [OpenAPI document](https://skmtc.dev/recordedfuture/apis/list-api/revisions/95042b3bf39c?raw)