Add Form Element

{
  "data": {
    "id": "string",
    "prompt": "string",
    "promptHidden": true,
    "helperText": "string",
    "type": "Text",
    "required": true,
    "propertyId": "string",
    "propertyData": {
      "type": "Text",
      "objectType": "contact",
      "status": "active"
    },
    "contactField": "firstName",
    "placeholder": "string"
  }
}

export interface Response {
  data:
    | (
        | {
            /**
             * The unique ID of this element. Present on existing elements returned from the backend, omitted when creating new ones.
             */
            id?: string;
            /**
             * For question elements, the question text; for static elements, a label shown above the element.
             */
            prompt: string;
            /**
             * If true, the element's prompt will not be shown to respondents.
             */
            promptHidden?: boolean;
            /**
             * Optional subtle helper text to display below the element.
             */
            helperText?: string;
            type: "Text";
            /**
             * If true, the respondent must answer this question to submit the form.
             */
            required: boolean;
            /**
             * ID of a CRM property that will be set by the answer to this question.
             * The CRM property's data type must align with the question's type.
             * For standalone forms, only Contact properties can be used.
             * For order forms, Ticket properties can be used for ticket-holder questions,
             * Order properties can be used for buyer-only questions, and Contact properties
             * can be used in either section.
             */
            propertyId?: string;
            /**
             * If propertyId is specified, this will contain additional data about the CRM property linked to this question. Populated by the backend when fetching the form, not saved to the database.
             */
            propertyData?: {
              type: "Text";
              /**
               * The kind of object that a form-linked CRM property writes to.
               * - contact: properties on customer contact records
               * - order: properties on orders (buyer-level)
               * - ticket: properties on individual products within an order
               */
              objectType: "contact" | "order" | "ticket";
              /**
               * Determines where this property can be used. "archived" properties are
               * soft-deleted (any existing reference to them remains valid) but only "active"
               * properties should be used in new workflows, forms, etc.
               */
              status: "active" | "archived";
            };
            /**
             * Instead of setting a custom CRM property, text questions may set the
             * built-in `firstName` and `lastName` fields on contacts.
             * Questions may set a CRM property, a contact field, or neither; but not both.
             */
            contactField?: "firstName" | "lastName";
            /**
             * Placeholder text to show when the input is empty.
             */
            placeholder?: string;
          }
        | {
            /**
             * The unique ID of this element. Present on existing elements returned from the backend, omitted when creating new ones.
             */
            id?: string;
            /**
             * For question elements, the question text; for static elements, a label shown above the element.
             */
            prompt: string;
            /**
             * If true, the element's prompt will not be shown to respondents.
             */
            promptHidden?: boolean;
            /**
             * Optional subtle helper text to display below the element.
             */
            helperText?: string;
            type: "Multi-line Text";
            /**
             * If true, the respondent must answer this question to submit the form.
             */
            required: boolean;
            /**
             * ID of a CRM property that will be set by the answer to this question.
             * The CRM property's data type must align with the question's type.
             * For standalone forms, only Contact properties can be used.
             * For order forms, Ticket properties can be used for ticket-holder questions,
             * Order properties can be used for buyer-only questions, and Contact properties
             * can be used in either section.
             */
            propertyId?: string;
            /**
             * If propertyId is specified, this will contain additional data about the CRM property linked to this question. Populated by the backend when fetching the form, not saved to the database.
             */
            propertyData?: {
              type: "Multi-line Text";
              /**
               * The kind of object that a form-linked CRM property writes to.
               * - contact: properties on customer contact records
               * - order: properties on orders (buyer-level)
               * - ticket: properties on individual products within an order
               */
              objectType: "contact" | "order" | "ticket";
              /**
               * Determines where this property can be used. "archived" properties are
               * soft-deleted (any existing reference to them remains valid) but only "active"
               * properties should be used in new workflows, forms, etc.
               */
              status: "active" | "archived";
            };
            /**
             * Placeholder text to show when the input is empty.
             */
            placeholder?: string;
          }
        | {
            /**
             * The unique ID of this element. Present on existing elements returned from the backend, omitted when creating new ones.
             */
            id?: string;
            /**
             * For question elements, the question text; for static elements, a label shown above the element.
             */
            prompt: string;
            /**
             * If true, the element's prompt will not be shown to respondents.
             */
            promptHidden?: boolean;
            /**
             * Optional subtle helper text to display below the element.
             */
            helperText?: string;
            type: "Select One";
            /**
             * If true, the respondent must answer this question to submit the form.
             */
            required: boolean;
            /**
             * If the question is not linked to a CRM property, this array will contain the question's options. If the question is linked to a CRM property, the options are derived from the CRM property, and this field will be undefined.
             */
            options?: string[];
            /**
             * ID of a CRM property that will be set by the answer to this question.
             * The CRM property's data type must align with the question's type.
             * For standalone forms, only Contact properties can be used.
             * For order forms, Ticket properties can be used for ticket-holder questions,
             * Order properties can be used for buyer-only questions, and Contact properties
             * can be used in either section.
             * If specified, the property also provides the selectable options, and exactly
             * one of `propertyId` or `options` must be specified.
             */
            propertyId?: string;
            /**
             * If propertyId is specified, this will contain additional data about the CRM property linked to this question. Populated by the backend when fetching the form, not saved to the database. If a question is linked to a CRM property, its options are used instead of unique options being defined in the question.
             */
            propertyData?: {
              options: {
                /**
                 * The value stored when this option is selected.
                 */
                value: string;
                /**
                 * The display label for this option.
                 */
                label: string;
              }[];
              type: "Select One";
              /**
               * The kind of object that a form-linked CRM property writes to.
               * - contact: properties on customer contact records
               * - order: properties on orders (buyer-level)
               * - ticket: properties on individual products within an order
               */
              objectType: "contact" | "order" | "ticket";
              /**
               * Determines where this property can be used. "archived" properties are
               * soft-deleted (any existing reference to them remains valid) but only "active"
               * properties should be used in new workflows, forms, etc.
               */
              status: "active" | "archived";
            };
            /**
             * If true, renders as a dropdown list instead of radio buttons.
             */
            dropdown?: boolean;
            /**
             * Only visible when `dropdown` is true.
             */
            placeholder?: string;
            /**
             * Conditional logic groups that reveal other elements based on selected options
             */
            logicGroups?: {
              /**
               * The index of the element in the form's `elements` array which is revealed
               * when this logic group's condition is satisfied.
               */
              revealedElementIndex: number;
              /**
               * The indices of the options in the question's `options` array, or its
               * custom property's options. The way these options are used depends on the
               * `operator` property.
               * An index of -1 specifies the "Other" option, for applicable question types.
               */
              optionIndices: number[];
              /**
               * The operator applied to the options specified by the `optionIndices` property
               */
              operator: "all_of" | "any_of" | "none_of";
            }[];
          }
        | {
            /**
             * The unique ID of this element. Present on existing elements returned from the backend, omitted when creating new ones.
             */
            id?: string;
            /**
             * For question elements, the question text; for static elements, a label shown above the element.
             */
            prompt: string;
            /**
             * If true, the element's prompt will not be shown to respondents.
             */
            promptHidden?: boolean;
            /**
             * Optional subtle helper text to display below the element.
             */
            helperText?: string;
            type: 'Select One or "Other"';
            /**
             * If true, the respondent must answer this question to submit the form.
             */
            required: boolean;
            /**
             * If the question is not linked to a CRM property, this array will contain the question's options. If the question is linked to a CRM property, the options are derived from the CRM property, and this field will be undefined.
             */
            options?: string[];
            /**
             * ID of a CRM property that will be set by the answer to this question.
             * The CRM property's data type must align with the question's type.
             * For standalone forms, only Contact properties can be used.
             * For order forms, Ticket properties can be used for ticket-holder questions,
             * Order properties can be used for buyer-only questions, and Contact properties
             * can be used in either section.
             * If specified, the property also provides the selectable options, and exactly
             * one of `propertyId` or `options` must be specified.
             */
            propertyId?: string;
            /**
             * If propertyId is specified, this will contain additional data about the CRM property linked to this question. Populated by the backend when fetching the form, not saved to the database. If a question is linked to a CRM property, its options are used instead of unique options being defined in the question.
             */
            propertyData?: {
              options: {
                /**
                 * The value stored when this option is selected.
                 */
                value: string;
                /**
                 * The display label for this option.
                 */
                label: string;
              }[];
              type: "Select One";
              /**
               * The kind of object that a form-linked CRM property writes to.
               * - contact: properties on customer contact records
               * - order: properties on orders (buyer-level)
               * - ticket: properties on individual products within an order
               */
              objectType: "contact" | "order" | "ticket";
              /**
               * Determines where this property can be used. "archived" properties are
               * soft-deleted (any existing reference to them remains valid) but only "active"
               * properties should be used in new workflows, forms, etc.
               */
              status: "active" | "archived";
            };
            /**
             * The label for the freeform "Other" option.
             */
            otherPrompt: string;
            /**
             * Conditional logic groups that reveal other elements based on selected options
             */
            logicGroups?: {
              /**
               * The index of the element in the form's `elements` array which is revealed
               * when this logic group's condition is satisfied.
               */
              revealedElementIndex: number;
              /**
               * The indices of the options in the question's `options` array, or its
               * custom property's options. The way these options are used depends on the
               * `operator` property.
               * An index of -1 specifies the "Other" option, for applicable question types.
               */
              optionIndices: number[];
              /**
               * The operator applied to the options specified by the `optionIndices` property
               */
              operator: "all_of" | "any_of" | "none_of";
            }[];
          }
        | {
            /**
             * The unique ID of this element. Present on existing elements returned from the backend, omitted when creating new ones.
             */
            id?: string;
            /**
             * For question elements, the question text; for static elements, a label shown above the element.
             */
            prompt: string;
            /**
             * If true, the element's prompt will not be shown to respondents.
             */
            promptHidden?: boolean;
            /**
             * Optional subtle helper text to display below the element.
             */
            helperText?: string;
            type: "Select Multiple";
            /**
             * If the question is not linked to a CRM property, this array will contain the question's options. If the question is linked to a CRM property, the options are derived from the CRM property, and this field will be undefined.
             */
            options?: string[];
            /**
             * ID of a CRM property that will be set by the answer to this question.
             * The CRM property's data type must align with the question's type.
             * For standalone forms, only Contact properties can be used.
             * For order forms, Ticket properties can be used for ticket-holder questions,
             * Order properties can be used for buyer-only questions, and Contact properties
             * can be used in either section.
             * If specified, the property also provides the selectable options, and exactly
             * one of `propertyId` or `options` must be specified.
             */
            propertyId?: string;
            /**
             * If propertyId is specified, this will contain additional data about the CRM property linked to this question. Populated by the backend when fetching the form, not saved to the database. If a question is linked to a CRM property, its options are used instead of unique options being defined in the question.
             */
            propertyData?: {
              options: {
                /**
                 * The value stored when this option is selected.
                 */
                value: string;
                /**
                 * The display label for this option.
                 */
                label: string;
              }[];
              type: "Select Multiple";
              /**
               * The kind of object that a form-linked CRM property writes to.
               * - contact: properties on customer contact records
               * - order: properties on orders (buyer-level)
               * - ticket: properties on individual products within an order
               */
              objectType: "contact" | "order" | "ticket";
              /**
               * Determines where this property can be used. "archived" properties are
               * soft-deleted (any existing reference to them remains valid) but only "active"
               * properties should be used in new workflows, forms, etc.
               */
              status: "active" | "archived";
            };
            /**
             * Reserved for future use, must not be set to true
             */
            dropdown?: false;
            /**
             * Minimum number of options that must be selected. Set to 0 to make the question optional.
             */
            minChoices: number;
            /**
             * Maximum number of options that can be selected, or no limit if omitted
             */
            maxChoices?: number;
            /**
             * Conditional logic groups that reveal other elements based on selected options
             */
            logicGroups?: {
              /**
               * The index of the element in the form's `elements` array which is revealed
               * when this logic group's condition is satisfied.
               */
              revealedElementIndex: number;
              /**
               * The indices of the options in the question's `options` array, or its
               * custom property's options. The way these options are used depends on the
               * `operator` property.
               * An index of -1 specifies the "Other" option, for applicable question types.
               */
              optionIndices: number[];
              /**
               * The operator applied to the options specified by the `optionIndices` property
               */
              operator: "all_of" | "any_of" | "none_of";
            }[];
          }
        | {
            /**
             * The unique ID of this element. Present on existing elements returned from the backend, omitted when creating new ones.
             */
            id?: string;
            /**
             * For question elements, the question text; for static elements, a label shown above the element.
             */
            prompt: string;
            /**
             * If true, the element's prompt will not be shown to respondents.
             */
            promptHidden?: boolean;
            /**
             * Optional subtle helper text to display below the element.
             */
            helperText?: string;
            type: 'Select Multiple with "Other"';
            /**
             * If the question is not linked to a CRM property, this array will contain the question's options. If the question is linked to a CRM property, the options are derived from the CRM property, and this field will be undefined.
             */
            options?: string[];
            /**
             * ID of a CRM property that will be set by the answer to this question.
             * The CRM property's data type must align with the question's type.
             * For standalone forms, only Contact properties can be used.
             * For order forms, Ticket properties can be used for ticket-holder questions,
             * Order properties can be used for buyer-only questions, and Contact properties
             * can be used in either section.
             * If specified, the property also provides the selectable options, and exactly
             * one of `propertyId` or `options` must be specified.
             */
            propertyId?: string;
            /**
             * If propertyId is specified, this will contain additional data about the CRM property linked to this question. Populated by the backend when fetching the form, not saved to the database. If a question is linked to a CRM property, its options are used instead of unique options being defined in the question.
             */
            propertyData?: {
              options: {
                /**
                 * The value stored when this option is selected.
                 */
                value: string;
                /**
                 * The display label for this option.
                 */
                label: string;
              }[];
              type: "Select Multiple";
              /**
               * The kind of object that a form-linked CRM property writes to.
               * - contact: properties on customer contact records
               * - order: properties on orders (buyer-level)
               * - ticket: properties on individual products within an order
               */
              objectType: "contact" | "order" | "ticket";
              /**
               * Determines where this property can be used. "archived" properties are
               * soft-deleted (any existing reference to them remains valid) but only "active"
               * properties should be used in new workflows, forms, etc.
               */
              status: "active" | "archived";
            };
            /**
             * Minimum number of options that must be selected. Set to 0 to make the question optional.
             */
            minChoices: number;
            /**
             * Maximum number of options that can be selected, or no limit if omitted
             */
            maxChoices?: number;
            /**
             * The label for the freeform "Other" option.
             */
            otherPrompt: string;
            /**
             * Conditional logic groups that reveal other elements based on selected options
             */
            logicGroups?: {
              /**
               * The index of the element in the form's `elements` array which is revealed
               * when this logic group's condition is satisfied.
               */
              revealedElementIndex: number;
              /**
               * The indices of the options in the question's `options` array, or its
               * custom property's options. The way these options are used depends on the
               * `operator` property.
               * An index of -1 specifies the "Other" option, for applicable question types.
               */
              optionIndices: number[];
              /**
               * The operator applied to the options specified by the `optionIndices` property
               */
              operator: "all_of" | "any_of" | "none_of";
            }[];
          }
        | {
            /**
             * The unique ID of this element. Present on existing elements returned from the backend, omitted when creating new ones.
             */
            id?: string;
            /**
             * For question elements, the question text; for static elements, a label shown above the element.
             */
            prompt: string;
            /**
             * If true, the element's prompt will not be shown to respondents.
             */
            promptHidden?: boolean;
            /**
             * Optional subtle helper text to display below the element.
             */
            helperText?: string;
            type: "Yes/No";
            /**
             * If true, the respondent must answer this question to submit the form.
             */
            required: boolean;
            /**
             * ID of a CRM property that will be set by the answer to this question.
             * The CRM property's data type must align with the question's type.
             * For standalone forms, only Contact properties can be used.
             * For order forms, Ticket properties can be used for ticket-holder questions,
             * Order properties can be used for buyer-only questions, and Contact properties
             * can be used in either section.
             */
            propertyId?: string;
            /**
             * If propertyId is specified, this will contain additional data about the CRM property linked to this question. Populated by the backend when fetching the form, not saved to the database.
             */
            propertyData?: {
              type: "Yes/No";
              /**
               * The kind of object that a form-linked CRM property writes to.
               * - contact: properties on customer contact records
               * - order: properties on orders (buyer-level)
               * - ticket: properties on individual products within an order
               */
              objectType: "contact" | "order" | "ticket";
              /**
               * Determines where this property can be used. "archived" properties are
               * soft-deleted (any existing reference to them remains valid) but only "active"
               * properties should be used in new workflows, forms, etc.
               */
              status: "active" | "archived";
            };
            /**
             * Reserved for future use, must be set to true
             */
            dropdown: true;
            /**
             * Instead of setting a custom CRM property, yes/no questions may set the
             * built-in `status` fields on contacts, which represents whether the contact
             * wants to receive communications from the host. The two values that can be
             * set by a yes/no question are "opted-in" for "yes"/true, or "unsubscribed"
             * for "no"/false.
             * Questions may set a CRM property, a contact field, or neither; but not both.
             */
            contactField?: "status";
            /**
             * Conditional logic groups that reveal other elements based on the yes/no value.
             */
            logicGroups?: {
              /**
               * The index of the element in the form's `elements` array which is revealed
               * when this logic group's condition is satisfied.
               */
              revealedElementIndex: number;
              /**
               * Determines whether the question's value must be strictly equal to the logic
               * group's `value` property, or not strictly equal to it. Note that
               * `undefined` (no answer) is treated differently from an explicit `false`
               * answer.
               */
              selectionType: "is" | "is_not";
              /**
               * Determines the value which is compared to the form answer's value for this
               * logic group (the type of comparison depends on the `selectionType` property).
               */
              value: boolean;
            }[];
            /**
             * If true, respondents must answer "Yes" to this question to submit their response.
             */
            yesRequired?: boolean;
          }
        | {
            /**
             * The unique ID of this element. Present on existing elements returned from the backend, omitted when creating new ones.
             */
            id?: string;
            /**
             * For question elements, the question text; for static elements, a label shown above the element.
             */
            prompt: string;
            /**
             * If true, the element's prompt will not be shown to respondents.
             */
            promptHidden?: boolean;
            /**
             * Optional subtle helper text to display below the element.
             */
            helperText?: string;
            type: "Date";
            /**
             * If true, the respondent must answer this question to submit the form.
             */
            required: boolean;
            /**
             * Earliest selectable date in YYYY-MM-DD format
             */
            min?: string;
            /**
             * Latest selectable date in YYYY-MM-DD format
             */
            max?: string;
            /**
             * ID of a CRM property that will be set by the answer to this question.
             * The CRM property's data type must align with the question's type.
             * For standalone forms, only Contact properties can be used.
             * For order forms, Ticket properties can be used for ticket-holder questions,
             * Order properties can be used for buyer-only questions, and Contact properties
             * can be used in either section.
             */
            propertyId?: string;
            /**
             * If propertyId is specified, this will contain additional data about the CRM property linked to this question. Populated by the backend when fetching the form, not saved to the database.
             */
            propertyData?: {
              type: "Date";
              /**
               * The kind of object that a form-linked CRM property writes to.
               * - contact: properties on customer contact records
               * - order: properties on orders (buyer-level)
               * - ticket: properties on individual products within an order
               */
              objectType: "contact" | "order" | "ticket";
              /**
               * Determines where this property can be used. "archived" properties are
               * soft-deleted (any existing reference to them remains valid) but only "active"
               * properties should be used in new workflows, forms, etc.
               */
              status: "active" | "archived";
            };
          }
        | {
            /**
             * The unique ID of this element. Present on existing elements returned from the backend, omitted when creating new ones.
             */
            id?: string;
            /**
             * For question elements, the question text; for static elements, a label shown above the element.
             */
            prompt: string;
            /**
             * If true, the element's prompt will not be shown to respondents.
             */
            promptHidden?: boolean;
            /**
             * Optional subtle helper text to display below the element.
             */
            helperText?: string;
            type: "File";
            /**
             * If true, the respondent must answer this question to submit the form.
             */
            required: boolean;
            /**
             * File categories allowed to be uploaded. Must contain at least one element.
             *
             * @minItems 1
             */
            accept: [
              "images" | "documents" | "data" | "audio" | "video",
              ...("images" | "documents" | "data" | "audio" | "video")[]
            ];
            /**
             * ID of a CRM property that will be set by the answer to this question.
             * The CRM property's data type must align with the question's type.
             * For standalone forms, only Contact properties can be used.
             * For order forms, Ticket properties can be used for ticket-holder questions,
             * Order properties can be used for buyer-only questions, and Contact properties
             * can be used in either section.
             */
            propertyId?: string;
            /**
             * If propertyId is specified, this will contain additional data about the CRM property linked to this question. Populated by the backend when fetching the form, not saved to the database.
             */
            propertyData?: {
              type: "File";
              /**
               * The kind of object that a form-linked CRM property writes to.
               * - contact: properties on customer contact records
               * - order: properties on orders (buyer-level)
               * - ticket: properties on individual products within an order
               */
              objectType: "contact" | "order" | "ticket";
              /**
               * Determines where this property can be used. "archived" properties are
               * soft-deleted (any existing reference to them remains valid) but only "active"
               * properties should be used in new workflows, forms, etc.
               */
              status: "active" | "archived";
            };
          }
        | {
            /**
             * The unique ID of this element. Present on existing elements returned from the backend, omitted when creating new ones.
             */
            id?: string;
            /**
             * For question elements, the question text; for static elements, a label shown above the element.
             */
            prompt: string;
            /**
             * If true, the element's prompt will not be shown to respondents.
             */
            promptHidden?: boolean;
            /**
             * Optional subtle helper text to display below the element.
             */
            helperText?: string;
            type: "Email";
            /**
             * If true, the respondent must answer this question to submit the form.
             */
            required: boolean;
            /**
             * ID of a CRM property that will be set by the answer to this question.
             * The CRM property's data type must align with the question's type.
             * For standalone forms, only Contact properties can be used.
             * For order forms, Ticket properties can be used for ticket-holder questions,
             * Order properties can be used for buyer-only questions, and Contact properties
             * can be used in either section.
             */
            propertyId?: string;
            /**
             * If propertyId is specified, this will contain additional data about the CRM property linked to this question. Populated by the backend when fetching the form, not saved to the database.
             */
            propertyData?: {
              type: "Email";
              /**
               * The kind of object that a form-linked CRM property writes to.
               * - contact: properties on customer contact records
               * - order: properties on orders (buyer-level)
               * - ticket: properties on individual products within an order
               */
              objectType: "contact" | "order" | "ticket";
              /**
               * Determines where this property can be used. "archived" properties are
               * soft-deleted (any existing reference to them remains valid) but only "active"
               * properties should be used in new workflows, forms, etc.
               */
              status: "active" | "archived";
            };
            /**
             * Placeholder text to show when the input is empty.
             */
            placeholder?: string;
            /**
             * Instead of setting a custom CRM property, email questions may set the
             * built-in `email` field on contacts. A question which sets this contact
             * field is required if any other questions in the form use a `contactField`
             * or a Contact CRM property, since email is how contacts are identified.
             * Questions may set a CRM property, a contact field, or neither; but not both.
             */
            contactField?: "email";
          }
        | {
            /**
             * The unique ID of this element. Present on existing elements returned from the backend, omitted when creating new ones.
             */
            id?: string;
            /**
             * For question elements, the question text; for static elements, a label shown above the element.
             */
            prompt: string;
            /**
             * If true, the element's prompt will not be shown to respondents.
             */
            promptHidden?: boolean;
            /**
             * Optional subtle helper text to display below the element.
             */
            helperText?: string;
            type: "Phone";
            /**
             * If true, the respondent must answer this question to submit the form.
             */
            required: boolean;
            /**
             * ID of a CRM property that will be set by the answer to this question.
             * The CRM property's data type must align with the question's type.
             * For standalone forms, only Contact properties can be used.
             * For order forms, Ticket properties can be used for ticket-holder questions,
             * Order properties can be used for buyer-only questions, and Contact properties
             * can be used in either section.
             */
            propertyId?: string;
            /**
             * If propertyId is specified, this will contain additional data about the CRM property linked to this question. Populated by the backend when fetching the form, not saved to the database.
             */
            propertyData?: {
              type: "Phone";
              /**
               * The kind of object that a form-linked CRM property writes to.
               * - contact: properties on customer contact records
               * - order: properties on orders (buyer-level)
               * - ticket: properties on individual products within an order
               */
              objectType: "contact" | "order" | "ticket";
              /**
               * Determines where this property can be used. "archived" properties are
               * soft-deleted (any existing reference to them remains valid) but only "active"
               * properties should be used in new workflows, forms, etc.
               */
              status: "active" | "archived";
            };
            /**
             * Placeholder text to show when the input is empty.
             */
            placeholder?: string;
            /**
             * Instead of setting a custom CRM property, phone questions may set the
             * built-in `phone` field on contacts (i.e. the contact's phone number).
             * Questions may set a CRM property, a contact field, or neither; but not both.
             */
            contactField?: "phone";
          }
        | {
            /**
             * The unique ID of this element. Present on existing elements returned from the backend, omitted when creating new ones.
             */
            id?: string;
            /**
             * For question elements, the question text; for static elements, a label shown above the element.
             */
            prompt: string;
            /**
             * If true, the element's prompt will not be shown to respondents.
             */
            promptHidden?: boolean;
            /**
             * Optional subtle helper text to display below the element.
             */
            helperText?: string;
            type: "Static Text";
            /**
             * The text content displayed in the block
             */
            content: string;
          }
        | {
            /**
             * The unique ID of this element. Present on existing elements returned from the backend, omitted when creating new ones.
             */
            id?: string;
            /**
             * For question elements, the question text; for static elements, a label shown above the element.
             */
            prompt: string;
            /**
             * If true, the element's prompt will not be shown to respondents.
             */
            promptHidden?: boolean;
            /**
             * Optional subtle helper text to display below the element.
             */
            helperText?: string;
            type: "Static Image";
            /**
             * URL of the image to display
             */
            imageUrl: string;
            /**
             * Display width as a percentage of the container (1-100). Defaults to 100.
             */
            imageWidth?: number;
          }
      )
    | (
        | {
            /**
             * The unique ID of this element. Present on existing elements returned from the backend, omitted when creating new ones.
             */
            id?: string;
            /**
             * For question elements, the question text; for static elements, a label shown above the element.
             */
            prompt: string;
            /**
             * If true, the element's prompt will not be shown to respondents.
             */
            promptHidden?: boolean;
            /**
             * Optional subtle helper text to display below the element.
             */
            helperText?: string;
            type: "Text";
            /**
             * If true, the respondent must answer this question to submit the form.
             */
            required: boolean;
            /**
             * ID of a CRM property that will be set by the answer to this question.
             * The CRM property's data type must align with the question's type.
             * For standalone forms, only Contact properties can be used.
             * For order forms, Ticket properties can be used for ticket-holder questions,
             * Order properties can be used for buyer-only questions, and Contact properties
             * can be used in either section.
             */
            propertyId?: string;
            /**
             * If propertyId is specified, this will contain additional data about the CRM property linked to this question. Populated by the backend when fetching the form, not saved to the database.
             */
            propertyData?: {
              type: "Text";
              /**
               * The kind of object that a form-linked CRM property writes to.
               * - contact: properties on customer contact records
               * - order: properties on orders (buyer-level)
               * - ticket: properties on individual products within an order
               */
              objectType: "contact" | "order" | "ticket";
              /**
               * Determines where this property can be used. "archived" properties are
               * soft-deleted (any existing reference to them remains valid) but only "active"
               * properties should be used in new workflows, forms, etc.
               */
              status: "active" | "archived";
            };
            /**
             * Instead of setting a custom CRM property, text questions may set the
             * built-in `firstName` and `lastName` fields on contacts.
             * Questions may set a CRM property, a contact field, or neither; but not both.
             */
            contactField?: "firstName" | "lastName";
            /**
             * Placeholder text to show when the input is empty.
             */
            placeholder?: string;
            /**
             * For order forms only. Restricts this element to only appear when at least one
             * of the referenced event items or products is in the cart. If present (even if
             * empty), the element is hidden by default.
             */
            forEventItems?: (
              | {
                  type: "eventItem";
                  eventId: string;
                  itemId: string;
                }
              | {
                  type: "eventProduct";
                  eventId: string;
                  productId: string;
                }
              | {
                  type: "checkoutProduct";
                  /**
                   * The ID of the standalone checkout containing the product.
                   */
                  checkoutId: string;
                  productId: string;
                }
            )[];
            /**
             * For order forms only. If true, the element must be in a row greater than or
             * equal to `attendeeRowsStart`, and an instance of the element will appear for
             * every ticket in the cart. Otherwise, the element must be in a row less than
             * `attendeeRowsStart`, and only a single instance of the element will appear.
             */
            askAllAttendees: boolean;
          }
        | {
            /**
             * The unique ID of this element. Present on existing elements returned from the backend, omitted when creating new ones.
             */
            id?: string;
            /**
             * For question elements, the question text; for static elements, a label shown above the element.
             */
            prompt: string;
            /**
             * If true, the element's prompt will not be shown to respondents.
             */
            promptHidden?: boolean;
            /**
             * Optional subtle helper text to display below the element.
             */
            helperText?: string;
            type: "Multi-line Text";
            /**
             * If true, the respondent must answer this question to submit the form.
             */
            required: boolean;
            /**
             * ID of a CRM property that will be set by the answer to this question.
             * The CRM property's data type must align with the question's type.
             * For standalone forms, only Contact properties can be used.
             * For order forms, Ticket properties can be used for ticket-holder questions,
             * Order properties can be used for buyer-only questions, and Contact properties
             * can be used in either section.
             */
            propertyId?: string;
            /**
             * If propertyId is specified, this will contain additional data about the CRM property linked to this question. Populated by the backend when fetching the form, not saved to the database.
             */
            propertyData?: {
              type: "Multi-line Text";
              /**
               * The kind of object that a form-linked CRM property writes to.
               * - contact: properties on customer contact records
               * - order: properties on orders (buyer-level)
               * - ticket: properties on individual products within an order
               */
              objectType: "contact" | "order" | "ticket";
              /**
               * Determines where this property can be used. "archived" properties are
               * soft-deleted (any existing reference to them remains valid) but only "active"
               * properties should be used in new workflows, forms, etc.
               */
              status: "active" | "archived";
            };
            /**
             * Placeholder text to show when the input is empty.
             */
            placeholder?: string;
            /**
             * For order forms only. Restricts this element to only appear when at least one
             * of the referenced event items or products is in the cart. If present (even if
             * empty), the element is hidden by default.
             */
            forEventItems?: (
              | {
                  type: "eventItem";
                  eventId: string;
                  itemId: string;
                }
              | {
                  type: "eventProduct";
                  eventId: string;
                  productId: string;
                }
              | {
                  type: "checkoutProduct";
                  /**
                   * The ID of the standalone checkout containing the product.
                   */
                  checkoutId: string;
                  productId: string;
                }
            )[];
            /**
             * For order forms only. If true, the element must be in a row greater than or
             * equal to `attendeeRowsStart`, and an instance of the element will appear for
             * every ticket in the cart. Otherwise, the element must be in a row less than
             * `attendeeRowsStart`, and only a single instance of the element will appear.
             */
            askAllAttendees: boolean;
          }
        | {
            /**
             * The unique ID of this element. Present on existing elements returned from the backend, omitted when creating new ones.
             */
            id?: string;
            /**
             * For question elements, the question text; for static elements, a label shown above the element.
             */
            prompt: string;
            /**
             * If true, the element's prompt will not be shown to respondents.
             */
            promptHidden?: boolean;
            /**
             * Optional subtle helper text to display below the element.
             */
            helperText?: string;
            type: "Select One";
            /**
             * If true, the respondent must answer this question to submit the form.
             */
            required: boolean;
            /**
             * If the question is not linked to a CRM property, this array will contain the question's options. If the question is linked to a CRM property, the options are derived from the CRM property, and this field will be undefined.
             */
            options?: string[];
            /**
             * ID of a CRM property that will be set by the answer to this question.
             * The CRM property's data type must align with the question's type.
             * For standalone forms, only Contact properties can be used.
             * For order forms, Ticket properties can be used for ticket-holder questions,
             * Order properties can be used for buyer-only questions, and Contact properties
             * can be used in either section.
             * If specified, the property also provides the selectable options, and exactly
             * one of `propertyId` or `options` must be specified.
             */
            propertyId?: string;
            /**
             * If propertyId is specified, this will contain additional data about the CRM property linked to this question. Populated by the backend when fetching the form, not saved to the database. If a question is linked to a CRM property, its options are used instead of unique options being defined in the question.
             */
            propertyData?: {
              options: {
                /**
                 * The value stored when this option is selected.
                 */
                value: string;
                /**
                 * The display label for this option.
                 */
                label: string;
              }[];
              type: "Select One";
              /**
               * The kind of object that a form-linked CRM property writes to.
               * - contact: properties on customer contact records
               * - order: properties on orders (buyer-level)
               * - ticket: properties on individual products within an order
               */
              objectType: "contact" | "order" | "ticket";
              /**
               * Determines where this property can be used. "archived" properties are
               * soft-deleted (any existing reference to them remains valid) but only "active"
               * properties should be used in new workflows, forms, etc.
               */
              status: "active" | "archived";
            };
            /**
             * If true, renders as a dropdown list instead of radio buttons.
             */
            dropdown?: boolean;
            /**
             * Only visible when `dropdown` is true.
             */
            placeholder?: string;
            /**
             * Conditional logic groups that reveal other elements based on selected options
             */
            logicGroups?: {
              /**
               * The index of the element in the form's `elements` array which is revealed
               * when this logic group's condition is satisfied.
               */
              revealedElementIndex: number;
              /**
               * The indices of the options in the question's `options` array, or its
               * custom property's options. The way these options are used depends on the
               * `operator` property.
               * An index of -1 specifies the "Other" option, for applicable question types.
               */
              optionIndices: number[];
              /**
               * The operator applied to the options specified by the `optionIndices` property
               */
              operator: "all_of" | "any_of" | "none_of";
            }[];
            /**
             * For order forms only. Restricts this element to only appear when at least one
             * of the referenced event items or products is in the cart. If present (even if
             * empty), the element is hidden by default.
             */
            forEventItems?: (
              | {
                  type: "eventItem";
                  eventId: string;
                  itemId: string;
                }
              | {
                  type: "eventProduct";
                  eventId: string;
                  productId: string;
                }
              | {
                  type: "checkoutProduct";
                  /**
                   * The ID of the standalone checkout containing the product.
                   */
                  checkoutId: string;
                  productId: string;
                }
            )[];
            /**
             * For order forms only. If true, the element must be in a row greater than or
             * equal to `attendeeRowsStart`, and an instance of the element will appear for
             * every ticket in the cart. Otherwise, the element must be in a row less than
             * `attendeeRowsStart`, and only a single instance of the element will appear.
             */
            askAllAttendees: boolean;
          }
        | {
            /**
             * The unique ID of this element. Present on existing elements returned from the backend, omitted when creating new ones.
             */
            id?: string;
            /**
             * For question elements, the question text; for static elements, a label shown above the element.
             */
            prompt: string;
            /**
             * If true, the element's prompt will not be shown to respondents.
             */
            promptHidden?: boolean;
            /**
             * Optional subtle helper text to display below the element.
             */
            helperText?: string;
            type: 'Select One or "Other"';
            /**
             * If true, the respondent must answer this question to submit the form.
             */
            required: boolean;
            /**
             * If the question is not linked to a CRM property, this array will contain the question's options. If the question is linked to a CRM property, the options are derived from the CRM property, and this field will be undefined.
             */
            options?: string[];
            /**
             * ID of a CRM property that will be set by the answer to this question.
             * The CRM property's data type must align with the question's type.
             * For standalone forms, only Contact properties can be used.
             * For order forms, Ticket properties can be used for ticket-holder questions,
             * Order properties can be used for buyer-only questions, and Contact properties
             * can be used in either section.
             * If specified, the property also provides the selectable options, and exactly
             * one of `propertyId` or `options` must be specified.
             */
            propertyId?: string;
            /**
             * If propertyId is specified, this will contain additional data about the CRM property linked to this question. Populated by the backend when fetching the form, not saved to the database. If a question is linked to a CRM property, its options are used instead of unique options being defined in the question.
             */
            propertyData?: {
              options: {
                /**
                 * The value stored when this option is selected.
                 */
                value: string;
                /**
                 * The display label for this option.
                 */
                label: string;
              }[];
              type: "Select One";
              /**
               * The kind of object that a form-linked CRM property writes to.
               * - contact: properties on customer contact records
               * - order: properties on orders (buyer-level)
               * - ticket: properties on individual products within an order
               */
              objectType: "contact" | "order" | "ticket";
              /**
               * Determines where this property can be used. "archived" properties are
               * soft-deleted (any existing reference to them remains valid) but only "active"
               * properties should be used in new workflows, forms, etc.
               */
              status: "active" | "archived";
            };
            /**
             * The label for the freeform "Other" option.
             */
            otherPrompt: string;
            /**
             * Conditional logic groups that reveal other elements based on selected options
             */
            logicGroups?: {
              /**
               * The index of the element in the form's `elements` array which is revealed
               * when this logic group's condition is satisfied.
               */
              revealedElementIndex: number;
              /**
               * The indices of the options in the question's `options` array, or its
               * custom property's options. The way these options are used depends on the
               * `operator` property.
               * An index of -1 specifies the "Other" option, for applicable question types.
               */
              optionIndices: number[];
              /**
               * The operator applied to the options specified by the `optionIndices` property
               */
              operator: "all_of" | "any_of" | "none_of";
            }[];
            /**
             * For order forms only. Restricts this element to only appear when at least one
             * of the referenced event items or products is in the cart. If present (even if
             * empty), the element is hidden by default.
             */
            forEventItems?: (
              | {
                  type: "eventItem";
                  eventId: string;
                  itemId: string;
                }
              | {
                  type: "eventProduct";
                  eventId: string;
                  productId: string;
                }
              | {
                  type: "checkoutProduct";
                  /**
                   * The ID of the standalone checkout containing the product.
                   */
                  checkoutId: string;
                  productId: string;
                }
            )[];
            /**
             * For order forms only. If true, the element must be in a row greater than or
             * equal to `attendeeRowsStart`, and an instance of the element will appear for
             * every ticket in the cart. Otherwise, the element must be in a row less than
             * `attendeeRowsStart`, and only a single instance of the element will appear.
             */
            askAllAttendees: boolean;
          }
        | {
            /**
             * The unique ID of this element. Present on existing elements returned from the backend, omitted when creating new ones.
             */
            id?: string;
            /**
             * For question elements, the question text; for static elements, a label shown above the element.
             */
            prompt: string;
            /**
             * If true, the element's prompt will not be shown to respondents.
             */
            promptHidden?: boolean;
            /**
             * Optional subtle helper text to display below the element.
             */
            helperText?: string;
            type: "Select Multiple";
            /**
             * If the question is not linked to a CRM property, this array will contain the question's options. If the question is linked to a CRM property, the options are derived from the CRM property, and this field will be undefined.
             */
            options?: string[];
            /**
             * ID of a CRM property that will be set by the answer to this question.
             * The CRM property's data type must align with the question's type.
             * For standalone forms, only Contact properties can be used.
             * For order forms, Ticket properties can be used for ticket-holder questions,
             * Order properties can be used for buyer-only questions, and Contact properties
             * can be used in either section.
             * If specified, the property also provides the selectable options, and exactly
             * one of `propertyId` or `options` must be specified.
             */
            propertyId?: string;
            /**
             * If propertyId is specified, this will contain additional data about the CRM property linked to this question. Populated by the backend when fetching the form, not saved to the database. If a question is linked to a CRM property, its options are used instead of unique options being defined in the question.
             */
            propertyData?: {
              options: {
                /**
                 * The value stored when this option is selected.
                 */
                value: string;
                /**
                 * The display label for this option.
                 */
                label: string;
              }[];
              type: "Select Multiple";
              /**
               * The kind of object that a form-linked CRM property writes to.
               * - contact: properties on customer contact records
               * - order: properties on orders (buyer-level)
               * - ticket: properties on individual products within an order
               */
              objectType: "contact" | "order" | "ticket";
              /**
               * Determines where this property can be used. "archived" properties are
               * soft-deleted (any existing reference to them remains valid) but only "active"
               * properties should be used in new workflows, forms, etc.
               */
              status: "active" | "archived";
            };
            /**
             * Reserved for future use, must not be set to true
             */
            dropdown?: false;
            /**
             * Minimum number of options that must be selected. Set to 0 to make the question optional.
             */
            minChoices: number;
            /**
             * Maximum number of options that can be selected, or no limit if omitted
             */
            maxChoices?: number;
            /**
             * Conditional logic groups that reveal other elements based on selected options
             */
            logicGroups?: {
              /**
               * The index of the element in the form's `elements` array which is revealed
               * when this logic group's condition is satisfied.
               */
              revealedElementIndex: number;
              /**
               * The indices of the options in the question's `options` array, or its
               * custom property's options. The way these options are used depends on the
               * `operator` property.
               * An index of -1 specifies the "Other" option, for applicable question types.
               */
              optionIndices: number[];
              /**
               * The operator applied to the options specified by the `optionIndices` property
               */
              operator: "all_of" | "any_of" | "none_of";
            }[];
            /**
             * For order forms only. Restricts this element to only appear when at least one
             * of the referenced event items or products is in the cart. If present (even if
             * empty), the element is hidden by default.
             */
            forEventItems?: (
              | {
                  type: "eventItem";
                  eventId: string;
                  itemId: string;
                }
              | {
                  type: "eventProduct";
                  eventId: string;
                  productId: string;
                }
              | {
                  type: "checkoutProduct";
                  /**
                   * The ID of the standalone checkout containing the product.
                   */
                  checkoutId: string;
                  productId: string;
                }
            )[];
            /**
             * For order forms only. If true, the element must be in a row greater than or
             * equal to `attendeeRowsStart`, and an instance of the element will appear for
             * every ticket in the cart. Otherwise, the element must be in a row less than
             * `attendeeRowsStart`, and only a single instance of the element will appear.
             */
            askAllAttendees: boolean;
          }
        | {
            /**
             * The unique ID of this element. Present on existing elements returned from the backend, omitted when creating new ones.
             */
            id?: string;
            /**
             * For question elements, the question text; for static elements, a label shown above the element.
             */
            prompt: string;
            /**
             * If true, the element's prompt will not be shown to respondents.
             */
            promptHidden?: boolean;
            /**
             * Optional subtle helper text to display below the element.
             */
            helperText?: string;
            type: 'Select Multiple with "Other"';
            /**
             * If the question is not linked to a CRM property, this array will contain the question's options. If the question is linked to a CRM property, the options are derived from the CRM property, and this field will be undefined.
             */
            options?: string[];
            /**
             * ID of a CRM property that will be set by the answer to this question.
             * The CRM property's data type must align with the question's type.
             * For standalone forms, only Contact properties can be used.
             * For order forms, Ticket properties can be used for ticket-holder questions,
             * Order properties can be used for buyer-only questions, and Contact properties
             * can be used in either section.
             * If specified, the property also provides the selectable options, and exactly
             * one of `propertyId` or `options` must be specified.
             */
            propertyId?: string;
            /**
             * If propertyId is specified, this will contain additional data about the CRM property linked to this question. Populated by the backend when fetching the form, not saved to the database. If a question is linked to a CRM property, its options are used instead of unique options being defined in the question.
             */
            propertyData?: {
              options: {
                /**
                 * The value stored when this option is selected.
                 */
                value: string;
                /**
                 * The display label for this option.
                 */
                label: string;
              }[];
              type: "Select Multiple";
              /**
               * The kind of object that a form-linked CRM property writes to.
               * - contact: properties on customer contact records
               * - order: properties on orders (buyer-level)
               * - ticket: properties on individual products within an order
               */
              objectType: "contact" | "order" | "ticket";
              /**
               * Determines where this property can be used. "archived" properties are
               * soft-deleted (any existing reference to them remains valid) but only "active"
               * properties should be used in new workflows, forms, etc.
               */
              status: "active" | "archived";
            };
            /**
             * Minimum number of options that must be selected. Set to 0 to make the question optional.
             */
            minChoices: number;
            /**
             * Maximum number of options that can be selected, or no limit if omitted
             */
            maxChoices?: number;
            /**
             * The label for the freeform "Other" option.
             */
            otherPrompt: string;
            /**
             * Conditional logic groups that reveal other elements based on selected options
             */
            logicGroups?: {
              /**
               * The index of the element in the form's `elements` array which is revealed
               * when this logic group's condition is satisfied.
               */
              revealedElementIndex: number;
              /**
               * The indices of the options in the question's `options` array, or its
               * custom property's options. The way these options are used depends on the
               * `operator` property.
               * An index of -1 specifies the "Other" option, for applicable question types.
               */
              optionIndices: number[];
              /**
               * The operator applied to the options specified by the `optionIndices` property
               */
              operator: "all_of" | "any_of" | "none_of";
            }[];
            /**
             * For order forms only. Restricts this element to only appear when at least one
             * of the referenced event items or products is in the cart. If present (even if
             * empty), the element is hidden by default.
             */
            forEventItems?: (
              | {
                  type: "eventItem";
                  eventId: string;
                  itemId: string;
                }
              | {
                  type: "eventProduct";
                  eventId: string;
                  productId: string;
                }
              | {
                  type: "checkoutProduct";
                  /**
                   * The ID of the standalone checkout containing the product.
                   */
                  checkoutId: string;
                  productId: string;
                }
            )[];
            /**
             * For order forms only. If true, the element must be in a row greater than or
             * equal to `attendeeRowsStart`, and an instance of the element will appear for
             * every ticket in the cart. Otherwise, the element must be in a row less than
             * `attendeeRowsStart`, and only a single instance of the element will appear.
             */
            askAllAttendees: boolean;
          }
        | {
            /**
             * The unique ID of this element. Present on existing elements returned from the backend, omitted when creating new ones.
             */
            id?: string;
            /**
             * For question elements, the question text; for static elements, a label shown above the element.
             */
            prompt: string;
            /**
             * If true, the element's prompt will not be shown to respondents.
             */
            promptHidden?: boolean;
            /**
             * Optional subtle helper text to display below the element.
             */
            helperText?: string;
            type: "Yes/No";
            /**
             * If true, the respondent must answer this question to submit the form.
             */
            required: boolean;
            /**
             * ID of a CRM property that will be set by the answer to this question.
             * The CRM property's data type must align with the question's type.
             * For standalone forms, only Contact properties can be used.
             * For order forms, Ticket properties can be used for ticket-holder questions,
             * Order properties can be used for buyer-only questions, and Contact properties
             * can be used in either section.
             */
            propertyId?: string;
            /**
             * If propertyId is specified, this will contain additional data about the CRM property linked to this question. Populated by the backend when fetching the form, not saved to the database.
             */
            propertyData?: {
              type: "Yes/No";
              /**
               * The kind of object that a form-linked CRM property writes to.
               * - contact: properties on customer contact records
               * - order: properties on orders (buyer-level)
               * - ticket: properties on individual products within an order
               */
              objectType: "contact" | "order" | "ticket";
              /**
               * Determines where this property can be used. "archived" properties are
               * soft-deleted (any existing reference to them remains valid) but only "active"
               * properties should be used in new workflows, forms, etc.
               */
              status: "active" | "archived";
            };
            /**
             * Reserved for future use, must be set to true
             */
            dropdown: true;
            /**
             * Instead of setting a custom CRM property, yes/no questions may set the
             * built-in `status` fields on contacts, which represents whether the contact
             * wants to receive communications from the host. The two values that can be
             * set by a yes/no question are "opted-in" for "yes"/true, or "unsubscribed"
             * for "no"/false.
             * Questions may set a CRM property, a contact field, or neither; but not both.
             */
            contactField?: "status";
            /**
             * Conditional logic groups that reveal other elements based on the yes/no value.
             */
            logicGroups?: {
              /**
               * The index of the element in the form's `elements` array which is revealed
               * when this logic group's condition is satisfied.
               */
              revealedElementIndex: number;
              /**
               * Determines whether the question's value must be strictly equal to the logic
               * group's `value` property, or not strictly equal to it. Note that
               * `undefined` (no answer) is treated differently from an explicit `false`
               * answer.
               */
              selectionType: "is" | "is_not";
              /**
               * Determines the value which is compared to the form answer's value for this
               * logic group (the type of comparison depends on the `selectionType` property).
               */
              value: boolean;
            }[];
            /**
             * If true, respondents must answer "Yes" to this question to submit their response.
             */
            yesRequired?: boolean;
            /**
             * For order forms only. Restricts this element to only appear when at least one
             * of the referenced event items or products is in the cart. If present (even if
             * empty), the element is hidden by default.
             */
            forEventItems?: (
              | {
                  type: "eventItem";
                  eventId: string;
                  itemId: string;
                }
              | {
                  type: "eventProduct";
                  eventId: string;
                  productId: string;
                }
              | {
                  type: "checkoutProduct";
                  /**
                   * The ID of the standalone checkout containing the product.
                   */
                  checkoutId: string;
                  productId: string;
                }
            )[];
            /**
             * For order forms only. If true, the element must be in a row greater than or
             * equal to `attendeeRowsStart`, and an instance of the element will appear for
             * every ticket in the cart. Otherwise, the element must be in a row less than
             * `attendeeRowsStart`, and only a single instance of the element will appear.
             */
            askAllAttendees: boolean;
          }
        | {
            /**
             * The unique ID of this element. Present on existing elements returned from the backend, omitted when creating new ones.
             */
            id?: string;
            /**
             * For question elements, the question text; for static elements, a label shown above the element.
             */
            prompt: string;
            /**
             * If true, the element's prompt will not be shown to respondents.
             */
            promptHidden?: boolean;
            /**
             * Optional subtle helper text to display below the element.
             */
            helperText?: string;
            type: "Date";
            /**
             * If true, the respondent must answer this question to submit the form.
             */
            required: boolean;
            /**
             * Earliest selectable date in YYYY-MM-DD format
             */
            min?: string;
            /**
             * Latest selectable date in YYYY-MM-DD format
             */
            max?: string;
            /**
             * ID of a CRM property that will be set by the answer to this question.
             * The CRM property's data type must align with the question's type.
             * For standalone forms, only Contact properties can be used.
             * For order forms, Ticket properties can be used for ticket-holder questions,
             * Order properties can be used for buyer-only questions, and Contact properties
             * can be used in either section.
             */
            propertyId?: string;
            /**
             * If propertyId is specified, this will contain additional data about the CRM property linked to this question. Populated by the backend when fetching the form, not saved to the database.
             */
            propertyData?: {
              type: "Date";
              /**
               * The kind of object that a form-linked CRM property writes to.
               * - contact: properties on customer contact records
               * - order: properties on orders (buyer-level)
               * - ticket: properties on individual products within an order
               */
              objectType: "contact" | "order" | "ticket";
              /**
               * Determines where this property can be used. "archived" properties are
               * soft-deleted (any existing reference to them remains valid) but only "active"
               * properties should be used in new workflows, forms, etc.
               */
              status: "active" | "archived";
            };
            /**
             * For order forms only. Restricts this element to only appear when at least one
             * of the referenced event items or products is in the cart. If present (even if
             * empty), the element is hidden by default.
             */
            forEventItems?: (
              | {
                  type: "eventItem";
                  eventId: string;
                  itemId: string;
                }
              | {
                  type: "eventProduct";
                  eventId: string;
                  productId: string;
                }
              | {
                  type: "checkoutProduct";
                  /**
                   * The ID of the standalone checkout containing the product.
                   */
                  checkoutId: string;
                  productId: string;
                }
            )[];
            /**
             * For order forms only. If true, the element must be in a row greater than or
             * equal to `attendeeRowsStart`, and an instance of the element will appear for
             * every ticket in the cart. Otherwise, the element must be in a row less than
             * `attendeeRowsStart`, and only a single instance of the element will appear.
             */
            askAllAttendees: boolean;
          }
        | {
            /**
             * The unique ID of this element. Present on existing elements returned from the backend, omitted when creating new ones.
             */
            id?: string;
            /**
             * For question elements, the question text; for static elements, a label shown above the element.
             */
            prompt: string;
            /**
             * If true, the element's prompt will not be shown to respondents.
             */
            promptHidden?: boolean;
            /**
             * Optional subtle helper text to display below the element.
             */
            helperText?: string;
            type: "File";
            /**
             * If true, the respondent must answer this question to submit the form.
             */
            required: boolean;
            /**
             * File categories allowed to be uploaded. Must contain at least one element.
             *
             * @minItems 1
             */
            accept: [
              "images" | "documents" | "data" | "audio" | "video",
              ...("images" | "documents" | "data" | "audio" | "video")[]
            ];
            /**
             * ID of a CRM property that will be set by the answer to this question.
             * The CRM property's data type must align with the question's type.
             * For standalone forms, only Contact properties can be used.
             * For order forms, Ticket properties can be used for ticket-holder questions,
             * Order properties can be used for buyer-only questions, and Contact properties
             * can be used in either section.
             */
            propertyId?: string;
            /**
             * If propertyId is specified, this will contain additional data about the CRM property linked to this question. Populated by the backend when fetching the form, not saved to the database.
             */
            propertyData?: {
              type: "File";
              /**
               * The kind of object that a form-linked CRM property writes to.
               * - contact: properties on customer contact records
               * - order: properties on orders (buyer-level)
               * - ticket: properties on individual products within an order
               */
              objectType: "contact" | "order" | "ticket";
              /**
               * Determines where this property can be used. "archived" properties are
               * soft-deleted (any existing reference to them remains valid) but only "active"
               * properties should be used in new workflows, forms, etc.
               */
              status: "active" | "archived";
            };
            /**
             * For order forms only. Restricts this element to only appear when at least one
             * of the referenced event items or products is in the cart. If present (even if
             * empty), the element is hidden by default.
             */
            forEventItems?: (
              | {
                  type: "eventItem";
                  eventId: string;
                  itemId: string;
                }
              | {
                  type: "eventProduct";
                  eventId: string;
                  productId: string;
                }
              | {
                  type: "checkoutProduct";
                  /**
                   * The ID of the standalone checkout containing the product.
                   */
                  checkoutId: string;
                  productId: string;
                }
            )[];
            /**
             * For order forms only. If true, the element must be in a row greater than or
             * equal to `attendeeRowsStart`, and an instance of the element will appear for
             * every ticket in the cart. Otherwise, the element must be in a row less than
             * `attendeeRowsStart`, and only a single instance of the element will appear.
             */
            askAllAttendees: boolean;
          }
        | {
            /**
             * The unique ID of this element. Present on existing elements returned from the backend, omitted when creating new ones.
             */
            id?: string;
            /**
             * For question elements, the question text; for static elements, a label shown above the element.
             */
            prompt: string;
            /**
             * If true, the element's prompt will not be shown to respondents.
             */
            promptHidden?: boolean;
            /**
             * Optional subtle helper text to display below the element.
             */
            helperText?: string;
            type: "Email";
            /**
             * If true, the respondent must answer this question to submit the form.
             */
            required: boolean;
            /**
             * ID of a CRM property that will be set by the answer to this question.
             * The CRM property's data type must align with the question's type.
             * For standalone forms, only Contact properties can be used.
             * For order forms, Ticket properties can be used for ticket-holder questions,
             * Order properties can be used for buyer-only questions, and Contact properties
             * can be used in either section.
             */
            propertyId?: string;
            /**
             * If propertyId is specified, this will contain additional data about the CRM property linked to this question. Populated by the backend when fetching the form, not saved to the database.
             */
            propertyData?: {
              type: "Email";
              /**
               * The kind of object that a form-linked CRM property writes to.
               * - contact: properties on customer contact records
               * - order: properties on orders (buyer-level)
               * - ticket: properties on individual products within an order
               */
              objectType: "contact" | "order" | "ticket";
              /**
               * Determines where this property can be used. "archived" properties are
               * soft-deleted (any existing reference to them remains valid) but only "active"
               * properties should be used in new workflows, forms, etc.
               */
              status: "active" | "archived";
            };
            /**
             * Placeholder text to show when the input is empty.
             */
            placeholder?: string;
            /**
             * Instead of setting a custom CRM property, email questions may set the
             * built-in `email` field on contacts. A question which sets this contact
             * field is required if any other questions in the form use a `contactField`
             * or a Contact CRM property, since email is how contacts are identified.
             * Questions may set a CRM property, a contact field, or neither; but not both.
             */
            contactField?: "email";
            /**
             * For order forms only. Restricts this element to only appear when at least one
             * of the referenced event items or products is in the cart. If present (even if
             * empty), the element is hidden by default.
             */
            forEventItems?: (
              | {
                  type: "eventItem";
                  eventId: string;
                  itemId: string;
                }
              | {
                  type: "eventProduct";
                  eventId: string;
                  productId: string;
                }
              | {
                  type: "checkoutProduct";
                  /**
                   * The ID of the standalone checkout containing the product.
                   */
                  checkoutId: string;
                  productId: string;
                }
            )[];
            /**
             * For order forms only. If true, the element must be in a row greater than or
             * equal to `attendeeRowsStart`, and an instance of the element will appear for
             * every ticket in the cart. Otherwise, the element must be in a row less than
             * `attendeeRowsStart`, and only a single instance of the element will appear.
             */
            askAllAttendees: boolean;
          }
        | {
            /**
             * The unique ID of this element. Present on existing elements returned from the backend, omitted when creating new ones.
             */
            id?: string;
            /**
             * For question elements, the question text; for static elements, a label shown above the element.
             */
            prompt: string;
            /**
             * If true, the element's prompt will not be shown to respondents.
             */
            promptHidden?: boolean;
            /**
             * Optional subtle helper text to display below the element.
             */
            helperText?: string;
            type: "Phone";
            /**
             * If true, the respondent must answer this question to submit the form.
             */
            required: boolean;
            /**
             * ID of a CRM property that will be set by the answer to this question.
             * The CRM property's data type must align with the question's type.
             * For standalone forms, only Contact properties can be used.
             * For order forms, Ticket properties can be used for ticket-holder questions,
             * Order properties can be used for buyer-only questions, and Contact properties
             * can be used in either section.
             */
            propertyId?: string;
            /**
             * If propertyId is specified, this will contain additional data about the CRM property linked to this question. Populated by the backend when fetching the form, not saved to the database.
             */
            propertyData?: {
              type: "Phone";
              /**
               * The kind of object that a form-linked CRM property writes to.
               * - contact: properties on customer contact records
               * - order: properties on orders (buyer-level)
               * - ticket: properties on individual products within an order
               */
              objectType: "contact" | "order" | "ticket";
              /**
               * Determines where this property can be used. "archived" properties are
               * soft-deleted (any existing reference to them remains valid) but only "active"
               * properties should be used in new workflows, forms, etc.
               */
              status: "active" | "archived";
            };
            /**
             * Placeholder text to show when the input is empty.
             */
            placeholder?: string;
            /**
             * Instead of setting a custom CRM property, phone questions may set the
             * built-in `phone` field on contacts (i.e. the contact's phone number).
             * Questions may set a CRM property, a contact field, or neither; but not both.
             */
            contactField?: "phone";
            /**
             * For order forms only. Restricts this element to only appear when at least one
             * of the referenced event items or products is in the cart. If present (even if
             * empty), the element is hidden by default.
             */
            forEventItems?: (
              | {
                  type: "eventItem";
                  eventId: string;
                  itemId: string;
                }
              | {
                  type: "eventProduct";
                  eventId: string;
                  productId: string;
                }
              | {
                  type: "checkoutProduct";
                  /**
                   * The ID of the standalone checkout containing the product.
                   */
                  checkoutId: string;
                  productId: string;
                }
            )[];
            /**
             * For order forms only. If true, the element must be in a row greater than or
             * equal to `attendeeRowsStart`, and an instance of the element will appear for
             * every ticket in the cart. Otherwise, the element must be in a row less than
             * `attendeeRowsStart`, and only a single instance of the element will appear.
             */
            askAllAttendees: boolean;
          }
        | {
            /**
             * The unique ID of this element. Present on existing elements returned from the backend, omitted when creating new ones.
             */
            id?: string;
            /**
             * For question elements, the question text; for static elements, a label shown above the element.
             */
            prompt: string;
            /**
             * If true, the element's prompt will not be shown to respondents.
             */
            promptHidden?: boolean;
            /**
             * Optional subtle helper text to display below the element.
             */
            helperText?: string;
            type: "Static Text";
            /**
             * The text content displayed in the block
             */
            content: string;
            /**
             * For order forms only. Restricts this element to only appear when at least one
             * of the referenced event items or products is in the cart. If present (even if
             * empty), the element is hidden by default.
             */
            forEventItems?: (
              | {
                  type: "eventItem";
                  eventId: string;
                  itemId: string;
                }
              | {
                  type: "eventProduct";
                  eventId: string;
                  productId: string;
                }
              | {
                  type: "checkoutProduct";
                  /**
                   * The ID of the standalone checkout containing the product.
                   */
                  checkoutId: string;
                  productId: string;
                }
            )[];
            /**
             * For order forms only. If true, the element must be in a row greater than or
             * equal to `attendeeRowsStart`, and an instance of the element will appear for
             * every ticket in the cart. Otherwise, the element must be in a row less than
             * `attendeeRowsStart`, and only a single instance of the element will appear.
             */
            askAllAttendees: boolean;
          }
        | {
            /**
             * The unique ID of this element. Present on existing elements returned from the backend, omitted when creating new ones.
             */
            id?: string;
            /**
             * For question elements, the question text; for static elements, a label shown above the element.
             */
            prompt: string;
            /**
             * If true, the element's prompt will not be shown to respondents.
             */
            promptHidden?: boolean;
            /**
             * Optional subtle helper text to display below the element.
             */
            helperText?: string;
            type: "Static Image";
            /**
             * URL of the image to display
             */
            imageUrl: string;
            /**
             * Display width as a percentage of the container (1-100). Defaults to 100.
             */
            imageWidth?: number;
            /**
             * For order forms only. Restricts this element to only appear when at least one
             * of the referenced event items or products is in the cart. If present (even if
             * empty), the element is hidden by default.
             */
            forEventItems?: (
              | {
                  type: "eventItem";
                  eventId: string;
                  itemId: string;
                }
              | {
                  type: "eventProduct";
                  eventId: string;
                  productId: string;
                }
              | {
                  type: "checkoutProduct";
                  /**
                   * The ID of the standalone checkout containing the product.
                   */
                  checkoutId: string;
                  productId: string;
                }
            )[];
            /**
             * For order forms only. If true, the element must be in a row greater than or
             * equal to `attendeeRowsStart`, and an instance of the element will appear for
             * every ticket in the cart. Otherwise, the element must be in a row less than
             * `attendeeRowsStart`, and only a single instance of the element will appear.
             */
            askAllAttendees: boolean;
          }
      );
}