Create form template item
create_form_template_itemAdd one question (item) to a form template. Build a form by calling this once per question in order, or use bulk_create on form-template-items. Requires form_template_items:write scope.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| label | Yes | Question text / prompt shown to the user | |
| config | No | Per-type settings. number: { min, max, unit, integer, decimals }. text: { multiline, maxLength, placeholder }. multi_select: { minSelections, maxSelections }. photo: { minPhotos, maxPhotos }. Any single_select, multi_select, checkbox, number or text item can also carry followUp: { op, value, priority } - when the item's own answer matches (same operators as visible_when; priority LOW/MEDIUM/HIGH/URGENT), the technician is offered a follow-up work order, e.g. { op: "equals", value: "fail", priority: "HIGH" }. | |
| options | No | REQUIRED for single_select/multi_select: at least 2 choices as { value, label } with unique values. value is a machine slug (e.g. "fail"), label is shown to the user (e.g. "Fail"). Omit for other types. | |
| item_key | No | Optional stable key, unique within the template. OMIT IT and the server derives one from the label (recommended). Only set it when a later item’s visible_when must reference this one - then use a short slug like "compressor_status". | |
| required | No | Whether an answer is required to complete the form (default false) | |
| help_text | No | Optional hint shown under the label | |
| item_type | Yes | Pick by the answer you want: single_select = exactly one choice (Pass/Fail, Yes/No, Yes/No/N-A, or custom - supply options); multi_select = pick several (supply options); number = a numeric reading/count (use config.min/max/unit/integer); checkbox = a single done/not-done tick; text = free comment (config.multiline for long text); photo = photo evidence (config.maxPhotos); team_members = who took part (organization members picked from a list, plus named guests), e.g. meeting attendees; signature = a drawn sign-off, cleared automatically when any other answer changes, so place it last; section = a non-answerable heading that groups the questions under it. | |
| sort_order | Yes | Display order within the template (0-based; questions render in this order) | |
| template_id | Yes | Form template ID - resolve via list_form_templates | |
| visible_when | No | Optional conditional visibility { itemKey, op, value }. itemKey must reference an EARLIER item’s key (set that item’s item_key explicitly). Operators by referenced type - single_select/checkbox: equals, not_equals, in, not_in, is_answered, is_blank; number: gt, lt, gte, lte, equals, not_equals, is_answered, is_blank; text: is_answered, is_blank, equals, not_equals; multi_select: in, not_in, is_answered, is_blank. e.g. show a "Details" text item only when item "compressor_status" equals "fail". |