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.
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)requiredUUID of the parent experience.
- Example:
8e7d6c5b-4a39-4281-90ef-1a2b3c4d5e6f
Request bodyapplication/json, required
namemap of stringnullableMultilingual text keyed by 2-letter language code. Returned as this full object by default; collapses to a plain string when the
languagequery parameter is used.descriptionmap of stringnullableMultilingual text keyed by 2-letter language code. Returned as this full object by default; collapses to a plain string when the
languagequery parameter is used.minAgeintegernullableMinimum age (inclusive).
- Example:
65
maxAgeintegernullableMaximum age (inclusive).
capacityExemptbooleanExclude this type from capacity counting.
- Example:
false
sortOrderintegerDisplay position (ascending).
- Example:
4
isDefaultbooleanWhether 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
externalIdstringnullableExternal provider identifier (used by provider sync).
Example: Senior type with an age floor
{
"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-onlyThe parent experience id.
- Example:
8e7d6c5b-4a39-4281-90ef-1a2b3c4d5e6f
namemap of stringnullableMultilingual text keyed by 2-letter language code. Returned as this full object by default; collapses to a plain string when the
languagequery parameter is used.descriptionmap of stringnullableMultilingual text keyed by 2-letter language code. Returned as this full object by default; collapses to a plain string when the
languagequery parameter is used.minAgeintegernullableMinimum age (inclusive), or null when unbounded.
- Example:
18
maxAgeintegernullableMaximum age (inclusive), or null when unbounded.
capacityExemptbooleanWhen true, participants of this type (e.g. infants) do not count toward slot or variant capacity.
- Example:
false
sortOrderintegerDisplay position (ascending).
- Example:
0
isDefaultbooleanTrue for the seeded Adult/Child/Infant types. Default types cannot be deleted and only their age range can be edited.
- Example:
true
externalIdstringnullableExternal provider identifier when synced from Bokun/Regiondo/Kompas.
isEnabledOnBookableOptionsbooleanread-onlyComputed: 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
{
"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[].fieldanderrors[].code.- 401
Missing or invalid
X-API-Keyheader.- 404
The resource does not exist or belongs to another partner (existence is not leaked across partners).
Error body
typestringError class.
- Allowed values:
validation_errorclient_errorserver_error- Example:
validation_error
errorsobject[]Child fields
codestringMachine-readable error code.
- Example:
required
fieldstringnullableOffending field, or null/'general' for non-field errors.
- Example:
startTime
messagestringHuman-readable message.
- Example:
This field is required.
{
"type": "validation_error",
"errors": [
{
"code": "required",
"field": "startTime",
"message": "This field is required."
}
]
}