List personas, or create one with POST. derived from route
URL
- User APIhttps://sales.mattering.io/api/user/v1/personas/
- Service tierhttps://sales.mattering.io/api/internal/personas/
Query parameters
| Name | Default |
|---|---|
archived_only | none |
include_archived | none |
keyword | none |
limit | 100 |
space_id | none |
Body keys (JSON)
| Key | Required | Default |
|---|---|---|
name | optional or conditional | none |
space_id | optional or conditional | none |
Keys the view reads. A key not in this list is ignored by the view, silently. Where a key is required only for some actions (for example the action dispatch), the description above says which.
Pagination
Accepts limit and offset and the server caps limit at 500. Check the response for a total or count field.
Responses
200 data and meta envelope, legacy keys repeated beside data
{
"data": {
"personas": [
{
"name": "...",
"summary": "...",
"icon": "...",
"color": "...",
"created_at": "2026-01-01T00:00:00Z",
"updated_at": "2026-01-01T00:00:00Z",
"id": "...",
"is_archived": true,
"completeness": "...",
"demographics": "...",
"psychographics": "..."
}
]
},
"meta": {
"total": 0,
"limit": 0,
"offset": 0
}
}
201 data and meta envelope, legacy keys repeated beside data
{
"data": {
"persona": {
"name": "...",
"summary": "...",
"icon": "...",
"color": "...",
"created_at": "2026-01-01T00:00:00Z",
"updated_at": "2026-01-01T00:00:00Z",
"id": "...",
"is_archived": true,
"completeness": "...",
"demographics": "...",
"psychographics": "..."
}
},
"meta": {
"total": 0,
"limit": 0,
"offset": 0
}
}
Field names come from the code; values are placeholders (... is a string, 0 a number, dates are ISO 8601).
Errors
| Status | Code |
|---|---|
| 400 | name_required |
| 401 | unauthorized |
| 404 | space_not_found_or_forbidden |
Example
curl -X POST "https://sales.mattering.io/api/user/v1/personas/" \
-H "Authorization: Bearer $MATTERING_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "...",
"space_id": "..."
}'curl -X POST "https://sales.mattering.io/api/internal/personas/" \
-H "X-Internal-Secret: $MATTERING_INTERNAL_API_SECRET" \
-H "X-Internal-Org-Id: $ORG_ID" \
-H "X-Internal-User-Email: you@example.com" \
-H "Content-Type: application/json" \
-d '{
"name": "...",
"space_id": "..."
}'
Source: CRMCore/internal_api.py (internal_api.personas)