Create a new persona

Creates a new persona.

Requires authentication.

Request

POST /personas

Headers

HeaderValue
AuthorizationBearer <token>
Content-Typeapplication/json

Request Body

FieldTypeRequiredDescription
nameobjectYesMultilingual display name. Keys are language codes (e.g. {"en": "VIP Customers", "de": "VIP-Kunden"}).
descriptionobjectNoMultilingual description. Keys are language codes.
identifierstringYesUnique machine-readable identifier. Used in search constraints.
updatedBystringYesEmail or name of the user creating this persona.
instancestringYesThe 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]"
}
Body Params
name
object
required

Add Name per Language

description
object

Add Description per Language

string
required
string
required

Your email address or your name

string
required
Response
201

Persona created

Language
Credentials
Bearer
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here!