Skip to main content
POST
Save list

Authorizations

Authorization
string
header
required

Workspace-scoped Dench API key from workspace settings. This is the same key used by DENCH_API_KEY in sandboxes.

Body

application/json
createdFrom
enum<string>
required

Use find_people, find_companies or find_jobs for a prospect list.

Available options:
find_people,
find_companies,
find_jobs,
mixed,
watch_fire,
generate_image
title
string
required

Name of the new list.

Minimum string length: 1
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
any

Original search filters to retain with the list. Saving does not run a search.

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

Successful response

artifactId
string
required
filePath
string
required
rowCount
number
required
previewRows
any[]
required
title
string
required
createdFrom
string
required