Create a custom participant type

POST/v2/experiences/{experienceId}/participant-types

Requires your API key in the X-API-Key header.

Creates a custom participant type (e.g. Senior, Student) on the experience. The three default types (Adult, Child, Infant) are seeded automatically when the experience is created and cannot be created via the API.

A newly created custom type starts disabled on every existing option of the experience: organizers must explicitly enable it per option (by removing it from the option's disabledParticipantTypes) and, on per-person priced options, add a participantPrices entry for it before it can be booked. Creating a type may enqueue auto-translation of the experience content.

Requestbash
curl -X POST "https://api.turneo.co/v2/experiences/8e7d6c5b-4a39-4281-90ef-1a2b3c4d5e6f/participant-types" \
  -H "X-API-Key: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": {
      "en": "Senior"
    },
    "minAge": 65,
    "sortOrder": 4
  }'

Path parameters

  • experienceIdstring (uuid)required

    UUID of the parent experience.

    Example:
    8e7d6c5b-4a39-4281-90ef-1a2b3c4d5e6f

Request bodyapplication/json, required

  • namemap of stringnullable

    Multilingual text keyed by 2-letter language code. Returned as this full object by default; collapses to a plain string when the language query parameter is used.

  • descriptionmap of stringnullable

    Multilingual text keyed by 2-letter language code. Returned as this full object by default; collapses to a plain string when the language query parameter is used.

  • minAgeintegernullable

    Minimum age (inclusive).

    Example:
    65
  • maxAgeintegernullable

    Maximum age (inclusive).

  • capacityExemptboolean

    Exclude this type from capacity counting.

    Example:
    false
  • sortOrderinteger

    Display position (ascending).

    Example:
    4
  • isDefaultboolean

    Whether this is a seeded default type. Custom types created through the API should leave this false; non-default types start disabled on every existing option.

    Example:
    false
  • externalIdstringnullable

    External provider identifier (used by provider sync).

Example: Senior type with an age floor
Senior type with an age floorjson
{
  "name": {
    "en": "Senior"
  },
  "minAge": 65,
  "sortOrder": 4
}

Responses

201object

Participant type created.

  • idstring (uuid)

    Participant type id.

    Example:
    a7c53f01-6f9c-4d1c-9c30-1c19a1a5bd44
  • experienceIdstring (uuid)read-only

    The parent experience id.

    Example:
    8e7d6c5b-4a39-4281-90ef-1a2b3c4d5e6f
  • namemap of stringnullable

    Multilingual text keyed by 2-letter language code. Returned as this full object by default; collapses to a plain string when the language query parameter is used.

  • descriptionmap of stringnullable

    Multilingual text keyed by 2-letter language code. Returned as this full object by default; collapses to a plain string when the language query parameter is used.

  • minAgeintegernullable

    Minimum age (inclusive), or null when unbounded.

    Example:
    18
  • maxAgeintegernullable

    Maximum age (inclusive), or null when unbounded.

  • capacityExemptboolean

    When true, participants of this type (e.g. infants) do not count toward slot or variant capacity.

    Example:
    false
  • sortOrderinteger

    Display position (ascending).

    Example:
    0
  • isDefaultboolean

    True for the seeded Adult/Child/Infant types. Default types cannot be deleted and only their age range can be edited.

    Example:
    true
  • externalIdstringnullable

    External provider identifier when synced from Bokun/Regiondo/Kompas.

  • isEnabledOnBookableOptionsbooleanread-only

    Computed: true when at least one ACTIVE, non-custom option of the experience enables this type AND has a future bookable availability slot — i.e. a guest could actually book it right now.

    Example:
    true
Response 201json
{
  "id": "a7c53f01-6f9c-4d1c-9c30-1c19a1a5bd44",
  "experienceId": "8e7d6c5b-4a39-4281-90ef-1a2b3c4d5e6f",
  "name": {
    "en": "Shared boat tour",
    "de": "Gemeinsame Bootstour"
  },
  "description": {
    "en": "Shared boat tour",
    "de": "Gemeinsame Bootstour"
  },
  "minAge": 18,
  "maxAge": null,
  "capacityExempt": false,
  "sortOrder": 0,
  "isDefault": true,
  "externalId": null,
  "isEnabledOnBookableOptions": true
}

Errors

400

Validation failed. Inspect errors[].field and errors[].code.

401

Missing or invalid X-API-Key header.

404

The resource does not exist or belongs to another partner (existence is not leaked across partners).

Error body
  • typestring

    Error class.

    Allowed values:
    validation_errorclient_errorserver_error
    Example:
    validation_error
  • errorsobject[]
    Child fields
    • codestring

      Machine-readable error code.

      Example:
      required
    • fieldstringnullable

      Offending field, or null/'general' for non-field errors.

      Example:
      startTime
    • messagestring

      Human-readable message.

      Example:
      This field is required.
Response 400json
{
  "type": "validation_error",
  "errors": [
    {
      "code": "required",
      "field": "startTime",
      "message": "This field is required."
    }
  ]
}