Skip to main content
A persona is a named, reusable set of People Database filters saved by your team. It is a way to store an audience definition once — a job title, a country, a company size — and reference it by id instead of repeating the filters on every call. Personas are team-shared: every member of the team sees and can edit the same personas. A persona id (pdp_...) can be referenced elsewhere in the API, for example through the persona filter of a Signal Agent. Use Create persona to obtain an id, List personas to retrieve the ones your team already has, and Get Database Filters to discover the filterId values a persona can hold.
Alongside your own personas, lemlist derives one persona automatically from your AI business context. That one is internal: it is never returned by the API and cannot be deleted.

A People Database persona: a named, reusable set of People Database filters saved by your team. A persona id can be referenced elsewhere in the API, for example through the persona filter of a Signal Agent.

​
_id
string

Unique persona identifier

Example:

"pdp_ExAmPlE1234567890a"

​
name
string

Display name. Unique within your team.

Example:

"SaaS founders"

​
mode
enum<string>

Search mode the filters target

Available options:
leads,
companies
Example:

"leads"

​
filters
object[]

People Database filters defining the persona

​
createdAt
string<date-time>

Date the persona was created

Example:

"2026-07-31T09:12:00.000Z"

​
updatedAt
string<date-time>

Date of the last modification

Example:

"2026-07-31T09:12:00.000Z"