---
title: "Create a list"
method: POST
path: "/lists"
tags: ["Lists"]
---

# Create a list

`POST /lists`

## Request

- Base URL: `https://frontrun.vc/v1`
- URL: `https://frontrun.vc/v1/lists`
- Auth: API key in header `X-API-Key`

Create a list of accounts. Members outside the network come back in not_polled: track them with POST /track. Free.

## Request body

- object
  - `name` string, required
  - `handles` string[]
  - `feed` 'accounts' | 'network'
  - `sectors` string[]
  - `max_followers` integer, nullable
  - `min_tracking` integer, nullable

## Response `201`

The new list

- object

## Changes

- **2026-10-19** `6880b29e94c9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/frontrun/apis/frontrun-api/changes/lists/post.md)

---

[API](https://skmtc.dev/frontrun/apis/frontrun-api.md) · [All operations](https://skmtc.dev/frontrun/apis/frontrun-api/llms.txt) · [OpenAPI document](https://skmtc.dev/frontrun/apis/frontrun-api/revisions/6880b29e94c9?raw)