---
title: "Create a customer list."
method: POST
path: "/api/v1/lists"
---

# Create a customer list.

`POST /api/v1/lists`

## Request

- Base URL: `https://api.intentwake.com`
- URL: `https://api.intentwake.com/api/v1/lists`
- Auth: HTTP bearer

## Request body

- object
  - `name` string, required
  - `description` string
  - `folder_id` string, uuid, nullable
  - `monitor_enabled` boolean
  - `services` object[], required
    - `service_type` 'activity' | 'intent' | 'emaillogin', required
    - `sub_category_ids` string[]
  - `idempotency_key` string, required
  - `initial_entries` union
    - object
      - `mode` 'upload_session', required
      - `filename` string, required
      - `file_size` integer, required
      - `content_type` string
    - object
      - `mode` 'inline', required
      - `entries` string[], required

## Response `201`

List created.

- unknown

## Other responses

- `429`: Rate limit exceeded.
- `default`: Error response.

---

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