Skip to main content
POST
Create a persona
name and at least one entry in job_titles are required. The Sales Navigator URL returned in sales_nav_url is built from the filters you send. Set ai_expand_job_titles to true to expand job_titles with AI-generated variations (other seniority levels and languages); the suggested exclusions are added to excluded_job_titles. Get location IDs from the Location IDs endpoint.

Authorizations

X-API-KEY
string
header
required

Your API key

Headers

Idempotency-Key
string

A unique value you generate per operation, such as a UUID. Retrying with the same key and the same body returns the stored response instead of running the request again, so a retry after a timeout never charges twice. Successful responses are kept for 24 hours; a failed request is not stored and can be retried with the same key.

Maximum string length: 255
Example:

"4f1c2e9a-8a7d-4c1b-9f63-2d6e0b5a7c11"

Body

application/json
name
string
required

Name of the persona

Example:

"VP Engineering France"

job_titles
string[]
required

Job titles to include. At least one is required

Example:
description
string

Free-text description of the persona

Example:

"Engineering leaders at French SaaS scale-ups"

excluded_job_titles
string[]

Job titles to exclude

Example:
ai_expand_job_titles
boolean
default:false

When true, the titles in job_titles are expanded with AI into variations (other seniority levels and languages, based on your agent language preferences). Suggested exclusions are added to excluded_job_titles.

included_industries
string[]

LinkedIn industry IDs to include

Example:
excluded_industries
string[]

LinkedIn industry IDs to exclude

Example:
included_locations
string[]

Location IDs to include (see the Location IDs endpoint)

Example:
excluded_locations
string[]

Location IDs to exclude

Example:
company_size
enum<string>[]

Company headcount ranges. The LinkedIn size codes A–I are also accepted for older integrations, and are returned as sent.

Available options:
Self-employed,
1-10,
11-50,
51-200,
201-500,
501-1000,
1001-5000,
5001-10000,
10001+
Example:

Response

Persona created

uuid
string<uuid>

Unique identifier of the persona

Example:

"8e1dcba0-f0bb-4071-99fc-f18ba6559ccc"

name
string

Name of the persona

Example:

"VP Engineering France"

description
string | null

Free-text description

Example:

"Engineering leaders at French SaaS scale-ups"

included_job_titles
string[]

Job titles to include

Example:
excluded_job_titles
string[]

Job titles to exclude

Example:
included_industries
string[]

LinkedIn industry IDs to include

Example:
excluded_industries
string[]

LinkedIn industry IDs to exclude

Example:
included_locations
string[]

Location IDs to include

Example:
excluded_locations
string[]

Location IDs to exclude

Example:
company_size
string[]

Company size ranges

Example:
sales_nav_url
string | null

Sales Navigator search URL derived from the filters

Example:

"https://www.linkedin.com/sales/search/people?query=..."

created_at
string<date-time>

The creation date of the persona

Example:

"2025-01-03T17:35:33.073Z"

updated_at
string<date-time>

The last modified date of the persona

Example:

"2025-01-03T17:35:33.073Z"