Docs
Add Crew Attribute
POST /Events/{eventId}/settings/crew/attributes
POST
/Events/{eventId}/settings/crew/attributesRequired Tokens
| Field | Type | Required | Description |
|---|---|---|---|
| Bearer | Authorization: Bearer <api-key> | Optional | Your API key. Pass it as the Bearer token on every request. |
| Event token | x-Event-Token | Optional | Run **Get Tokens** in the Authorization folder, or call `GET /Events/{eventId}/authorize` manually. |
Creates a new custom attribute definition for crew members on this event. Once created, this attribute can be filled in on individual crew member records.
Requires EventAdmin permission on the event.
Path Parameters
| Field | Type | Required | Description |
|---|---|---|---|
| eventId | Guid | Required | The ID of the event. |
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
| name | string | Required | The display label for the attribute. Must not be empty. |
| type | string | Required | The attribute type. See table below for valid values. |
| options | string[] | Optional | Required when `type` is `Select` or `MultiSelect`. Must be `null` or omitted for other types. |
Attribute Types
| Type | Description | Options required? |
|---|---|---|
Text | Open-ended text input. | No |
RichText | Formatted rich text. | No |
Number | Numeric value. | No |
Date | Date picker (no time). | No |
DateTime | Date and time picker. | No |
Checkbox | Boolean yes/no. | No |
Link | URL input. | No |
File | Single file upload. | No |
MultiFile | Multiple file uploads. | No |
Select | Single selection from a predefined list. | Yes |
MultiSelect | Multiple selections from a predefined list. | Yes |
Example Request (Select)
{
"name": "T-Shirt Size",
"type": "Select",
"options": ["XS", "S", "M", "L", "XL", "XXL"]
}
Example Request (Text)
{
"name": "Dietary Restrictions",
"type": "Text",
"options": null
}
Response
201 Created — No response body.
Error Codes
| Code | HTTP Status | Description |
|---|---|---|
UNAUTHORIZED | 401 | Missing or invalid token. |
NOT_FOUND | 404 | Event not found. |
BAD_REQUEST | 400 | Invalid type, missing options for Select/MultiSelect, or options provided for a non-select type. |