> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Lemlist: List Personas

> List your team's saved Lemlist personas (reusable People Database filters). Includes SDK V2 examples, input constraints, response fields, and Deepline cost.

List your team's saved Lemlist personas (reusable People Database filters).

> [!NOTE]
>
> Tool ID: `lemlist_list_personas`

## Run this action

Use the TypeScript SDK for one call. Use `ctx.tools.execute(...)` inside a Play for durable calls, scheduled calls, or CSV processing.

```ts theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'lemlist_list_personas',
  {
    "mode": "leads"
  },
);

console.log(result.toolResponse.raw);
```

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute lemlist_list_personas --input '{
  "mode": "leads"
}' --json
```

## Example response

The SDK returns this shape at `result.toolResponse.raw`. The example values illustrate the response.

```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
{
  "data": {
    "data": [
      {
        "_id": "_123",
        "name": "Example",
        "mode": "leads"
      }
    ]
  }
}
```

Use `deepline describe lemlist_list_personas --json` for the latest machine-readable contract.

## Input reference

Lists the personas saved by your team. A persona is a named, reusable set of People Database filters. its id can then be referenced elsewhere in the API, for example through the `persona` filter of a Signal Agent. Personas are team-shared: every member sees the same list. Results are sorted by creation date, most recent first, and capped at 200. The auto-generated persona lemlist derives from your AI business context is never returned. Only the personas your team created are. This endpoint is in closed beta and answers `403` unless the beta is enabled for your team.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.mode` | `"leads" \| "companies"` | No | — | Restrict the list to personas of one search mode. Omit to return every persona of the team. Allowed: `leads`, `companies`. |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Lists the personas saved by your team. A persona is a named, reusable set of People Database filters; its id can then be referenced elsewhere in the API, for example through the `persona` filter of a Signal Agent. Personas are team-shared: every member sees the same list. Results are sorted by creation date, most recent first, and capped at 200. The auto-generated persona lemlist derives from your AI business context is never returned; only the personas your team created are. This endpoint is in closed beta and answers `403` unless the beta is enabled for your team.",
    "properties": {
      "mode": {
        "type": "string",
        "description": "Restrict the list to personas of one search mode. Omit to return every persona of the team.",
        "enum": [
          "leads",
          "companies"
        ]
      }
    },
    "required": [],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | Provider response payload. |
| `result.data.data` | `array` | No | — | The team's personas, most recently created first |
| `result.data.data[]._id` | `string` | No | — | Unique persona identifier |
| `result.data.data[].name` | `string` | No | — | Display name. Unique within your team. |
| `result.data.data[].mode` | `"leads" \| "companies"` | No | — | Search mode the filters target Allowed: `leads`, `companies`. |
| `result.data.data[].filters` | `array` | No | — | People Database filters defining the persona |
| `result.data.data[].filters[].filterId` | `string` | Yes | — | People Database filter identifier. Use [Get Database Filters](https://deepline.com/docs/api-reference/endpoints/people-database/get-database-filters) to discover the valid ids. |
| `result.data.data[].filters[].in` | `array` | No | — | Values to include |
| `result.data.data[].filters[].out` | `array` | No | — | Values to exclude |
| `result.data.data[].filters[].exactMatch` | `boolean` | No | — | Exact-match toggle, for the text filters that support it |
| `result.data.data[].createdAt` | `string` | No | — | Date the persona was created Format: `date-time`. |
| `result.data.data[].updatedAt` | `string` | No | — | Date of the last modification Format: `date-time`. |
| `result.meta` | `object` | No | — | Additional response metadata (status, paging). |

<details>
  <summary>Show raw output schema</summary>

  ### Output JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Standard tool result payload.",
    "properties": {
      "data": {
        "type": "object",
        "description": "Provider response payload.",
        "properties": {
          "data": {
            "type": "array",
            "description": "The team's personas, most recently created first",
            "items": {
              "type": "object",
              "description": "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.",
              "properties": {
                "_id": {
                  "type": "string",
                  "description": "Unique persona identifier"
                },
                "name": {
                  "type": "string",
                  "description": "Display name. Unique within your team."
                },
                "mode": {
                  "type": "string",
                  "description": "Search mode the filters target",
                  "enum": [
                    "leads",
                    "companies"
                  ]
                },
                "filters": {
                  "type": "array",
                  "description": "People Database filters defining the persona",
                  "items": {
                    "type": "object",
                    "description": "One People Database filter, as stored in a persona or a saved search. `in` includes matching values, `out` excludes them. There is no `type` property: it is derived from `filterId` server-side.",
                    "properties": {
                      "filterId": {
                        "type": "string",
                        "description": "People Database filter identifier. Use [Get Database Filters](/api-reference/endpoints/people-database/get-database-filters) to discover the valid ids."
                      },
                      "in": {
                        "type": "array",
                        "description": "Values to include",
                        "items": {
                          "type": "string"
                        }
                      },
                      "out": {
                        "type": "array",
                        "description": "Values to exclude",
                        "items": {
                          "type": "string"
                        }
                      },
                      "exactMatch": {
                        "type": "boolean",
                        "description": "Exact-match toggle, for the text filters that support it"
                      }
                    },
                    "required": [
                      "filterId"
                    ],
                    "additionalProperties": false
                  }
                },
                "createdAt": {
                  "type": "string",
                  "description": "Date the persona was created",
                  "format": "date-time"
                },
                "updatedAt": {
                  "type": "string",
                  "description": "Date of the last modification",
                  "format": "date-time"
                }
              },
              "additionalProperties": false
            }
          }
        },
        "additionalProperties": false
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": true
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Deepline cost

* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0` per pricing unit.
* Provider-native pricing may still exist outside Deepline credit billing.

## Related documentation

* [Lemlist provider guide](https://deepline.com/docs/providers/lemlist/guide.md)
* [SDK V2 quickstart](https://deepline.com/docs/sdk-v2/quickstart.md)
* [SDK reference](https://deepline.com/docs/sdk-v2/sdk-reference.md)
* [Run tools across a CSV](https://deepline.com/docs/sdk-v2/batch-csv.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.