Create Persona

Creates a new persona for the workspace — unlike PUT .../persona, this always creates a new record rather than replacing an existing one, so it is how a partner sets up a second business line. There is no limit on the number of personas a workspace can create through this endpoint.

Create a persona

POST/api/v2/partner/workspaces/{partner_workspace_id}/personas

Path parameters

Parameter	Type	Description
partner_workspace_id	string	Opaque workspace identifier from the partner system.

Request body

job_title and location are required; the other fields are optional.

Field	Type	Description
job_title	array of strings	Required. Target job titles — at least one entry.
exclude_job_title	array of strings	Job titles to exclude.
location	array of strings	Required. Target locations — at least one entry. Include at least one country (a city alone is not enough) so account mapping can run.
headcount	array of strings	Target company headcount ranges. Allowed values: `1-10`, `11-50`, `51-200`, `201-500`, `501-1,000`, `1,001-5,000`, `5,001-10,000`, `10,001+`.
industry	array of strings	Target industries.
seniority	array of strings	Target seniority levels. Allowed values: `owner`, `founder`, `c_suite`, `partner`, `vp`, `head`, `director`, `manager`, `senior`, `entry`, `intern`.
additional_info	string	Free-text additional instructions or context for the persona.
tag	string	Short free-form label you can set to recognise this persona in your own systems. Never used for targeting. Max 255 characters. Two personas of the same workspace cannot share a tag — reusing one returns `409 Conflict`.

Example request

curl -X POST "https://api.getsillage.com/api/v2/partner/workspaces/ws_123/personas" \
  -H "Authorization: Bearer $SILLAGE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "job_title": ["SDR"],
    "location": ["United States"],
    "tag": "smb-us"
  }'

Example response

201 Created:

{
  "data": {
    "id": 1235
  }
}

The response returns the id of the created persona.

Response fields

Field	Type	Description
data.id	integer	ID of the created persona. This ID is specific to your environment.
warnings	string[]	Non-blocking notices about the persona you just submitted, for example a missing `job_title`/`location` or a location that could not be resolved to a country. Omitted when there is nothing to report. Never blocks the write.

Errors

Status	Meaning
401	The master key is missing or invalid.
403	The master key is not authorized to access this resource.
404	No workspace found for this `partner_workspace_id`.
409	This tag is already used by another persona in this workspace.
422	Invalid request body.
429	Rate limit exceeded.
500	An unexpected server error occurred.

Error responses use RFC 9457 problem documents with Content-Type: application/problem+json.