Skip to main content
POST
Create Saved Search
name, filters and mode are all required. The name must be unique within your team — a duplicate answers 409.Pick your filters from Get Database Filters called with usage=ui: filters that are not usable in the People Database UI answer 400 with the code FILTER_UNAVAILABLE_FOR_USAGE. Filters incompatible with the mode or with your team’s plan are dropped silently.
The response contains only the created id. The stored name and filters are sanitized and plan-gated server-side — call Get saved search to read the stored saved search.

Authorizations

Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Body

application/json
name
string
required

Display name, 1 to 200 characters after trimming. Unique within your team.

Required string length: 1 - 200
Example:

"Paris SaaS founders"

filters
object[]
required

People Database filters of the saved search. 1 to 10 filters of shape { filterId, in?, out?, exactMatch? } (no other key: an unknown key such as type answers API_INVALID_FILTERS), at most 1000 values per in / out and 1000 characters per value.

Required array length: 1 - 10 elements
mode
enum<string>
required

Search mode the filters target

Available options:
leads,
companies
Example:

"leads"

Response

Saved search created

data
object