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

# POST /list/create

`POST /list/create`

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.net/recordedfuture/apis/alert-api.md) · [All operations](https://skmtc.net/recordedfuture/apis/alert-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/recordedfuture/alert-api/revisions/c8c2f68d8b60/schema)