post
https://{yourinstance}.makaira.io/personas
Creates a new persona.
Requires authentication.
Request
POST /personas
Headers
| Header | Value |
|---|---|
Authorization | Bearer <token> |
Content-Type | application/json |
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
name | object | Yes | Multilingual display name. Keys are language codes (e.g. {"en": "VIP Customers", "de": "VIP-Kunden"}). |
description | object | No | Multilingual description. Keys are language codes. |
identifier | string | Yes | Unique machine-readable identifier. Used in search constraints. |
updatedBy | string | Yes | Email or name of the user creating this persona. |
instance | string | Yes | The Makaira instance identifier. |
Example Request
{
"name": {
"en": "VIP Customers",
"de": "VIP-Kunden"
},
"description": {
"en": "Top-tier customers with exclusive offers",
"de": "Spitzenkunden mit exklusiven Angeboten"
},
"identifier": "vip-customers",
"updatedBy": "[email protected]",
"instance": "my-instance"
}Response
Returns the created persona object.
Example Response
{
"id": 5,
"name": {
"en": "VIP Customers",
"de": "VIP-Kunden"
},
"identifier": "vip-customers",
"updatedBy": "[email protected]"
} 201Persona created

