---
title: "Save list"
method: POST
path: "/lists"
tags: ["lists"]
---

# Save list

`POST /lists`

## Request

- Base URL: `https://www.dench.com/api/v1`
- URL: `https://www.dench.com/api/v1/lists`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Save find results as a named list (rows + filters become a workspace artifact).

## Request body

- object
  - `createdFrom` 'find_people' | 'find_companies' | 'find_jobs' | 'mixed' | 'watch_fire' | 'generate_image', required: Use find_people, find_companies or find_jobs for a prospect list.
  - `title` string, required: Name of the new list.
  - `saved` boolean: True makes the list visible in Find. Omitted saves an unlisted draft that can still be read or added to a campaign by id.
  - `filters` unknown
  - `people` object[]: Complete person records from a search, including existing contact details and custom fields.
  - `companies` object[]: Complete company records from a search.
  - `jobs` object[]: Complete job records from a search.

## Response `200`

Successful response

- object
  - `artifactId` string, required
  - `filePath` string, required
  - `rowCount` number, required
  - `previewRows` unknown[], required
    - unknown
  - `title` string, required
  - `createdFrom` string, required

## Other responses

- `400`: Invalid request
- `401`: Missing or invalid authentication
- `404`: Operation or resource not found
- `500`: Server error

---

[API](https://skmtc.dev/dench/apis/dench-api.md) - [All operations](https://skmtc.dev/dench/apis/dench-api/llms.txt) - [OpenAPI document](https://skmtc.dev/dench/apis/dench-api/revisions/4a145b38f19c?raw)