---
title: "Create an Unlocked List"
method: POST
path: "/profile/unlocked/lists"
tags: ["Unlocked Leaks Lists"]
---

# Create an Unlocked List

`POST /profile/unlocked/lists`

## Request

- Base URL: `https://api.leakradar.io`
- URL: `https://api.leakradar.io/profile/unlocked/lists`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/leakradar/apis/leakradar-io-api/docs/profile/unlocked/lists/post.ts> (a function with typed inputs; its response is checked against the schema)

Create a new list to organize your unlocked leaks.

Rules
- Maximum number of lists is determined by your current plan.
- List names must be unique per account, case-insensitive.

Response
- Returns the created list. `items_count` is 0 at creation time.

**Errors**
- 400 No plan, or maximum number of lists reached.
- 401 Authentication required, or invalid/expired API key.
- 409 A list with the same name already exists.
- 422 Request validation error.

## Request body

- UnlockedListCreateIn
  - `name` string, required
  - `color` string, nullable

## Response `200`

List created successfully.

- UnlockedListOut
  - `id` integer, required
  - `name` string, required
  - `color` string, nullable, required
  - `created_at` string, nullable, required
  - `updated_at` string, nullable, required
  - `items_count` integer, nullable

## Other responses

- `400`: No plan, or maximum number of lists reached.
- `401`: Authentication required, or invalid/expired API key.
- `409`: A list with the same name already exists.
- `422`: Validation error.

## Changes

- **2026-09-01** `82a99c608e1a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/leakradar/apis/leakradar-io-api/changes/profile/unlocked/lists/post.md)

---

[API](https://skmtc.dev/leakradar/apis/leakradar-io-api.md) - [All operations](https://skmtc.dev/leakradar/apis/leakradar-io-api/llms.txt) - [OpenAPI document](https://skmtc.dev/leakradar/apis/leakradar-io-api/revisions/8dcd4b54cc4a?raw)