---
title: "Create Company List"
method: POST
path: "/v0/company_lists"
tags: ["Company Lists"]
---

# Create Company List

`POST /v0/company_lists`

## Request body

- CompanyListCreate
  - `name` string, required — Name of the company list

## Response `200`

Successful Response

- CompanyList
  - `name` string, required — Name of the company list
  - `id` integer, required
  - `created_at` string, date-time, required
  - `deletable` boolean, nullable — Whether the list can be deleted
  - `companies_count` integer — Number of companies in the list
  - `user_id` integer, nullable — User ID of the list owner
  - `type` 'REVEALED_COMPANIES' | 'WEBHOOK_TRIGGERED' | 'MANUAL_CREATION' | 'EXPORT_SNAPSHOT'
  - `webhook_id` integer, nullable — Webhook ID of the list

## Other responses

- `400` — Bad Request
- `402` — Payment Required
- `422` — Unprocessable Content
- `500` — Internal Server Error

---

[API](https://skmtc.net/theirstack/apis/theirstack-api-reference.md) · [All operations](https://skmtc.net/theirstack/apis/theirstack-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/theirstack/theirstack-api-reference/revisions/13759eacef95/schema)