Skip to main content

FormDetail

A form with full field details.

created_atstring<datetime>required

When the form was created.

field_countintegerrequired

The number of fields in the form.

fields object[]required

The fields in the form.

  • Array [
  • descriptionstringnullable

    Optional help text displayed below the field.

    idstring

    Unique identifier for the field.

    keystringrequired

    Machine-readable key for the field. Must start with a lowercase letter and contain only lowercase letters, numbers, and underscores.

    Possible values: Value must match regular expression ^[a-z][a-z0-9_]*$

    labelstringrequired

    Display label for the field.

    must_be_trueboolean

    For boolean fields, whether the value must be true (e.g., consent checkboxes).

    options objectnullable

    Options configuration for choice-type fields.

    oneOf
    allow_otherbooleanrequired

    Whether to allow a free-text 'other' option.

    choices object[]required

    List of available choices.

  • Array [
  • idstringrequired

    Unique identifier for the choice.

    labelstringrequired

    Display label for the choice.

  • ]
  • positionintegerrequired

    Display position of the field within the form.

    requiredboolean

    Whether the field is required.

    sensitiveboolean

    Whether the field contains sensitive data.

    typestringrequired

    The field type.

    Possible values: [short_text, long_text, email, phone, boolean, radio, select, checkbox]

  • ]
  • idstringrequired

    Unique identifier for the form.

    Possible values: Value must match regular expression ^frm_\w{12}$

    internal_namestringrequired

    The name of the form.

    objectstringrequired

    String representing the object's type.

    Possible values: [form]

    updated_atstring<datetime>required

    When the form was last updated.

    FormDetail
    {
    "created_at": "2025-02-17T17:49:19Z",
    "field_count": 1,
    "fields": [
    {
    "description": null,
    "id": "ff_abc123",
    "key": "full_name",
    "label": "Full Name",
    "must_be_true": false,
    "options": null,
    "position": 0,
    "required": true,
    "sensitive": false,
    "type": "short_text"
    }
    ],
    "id": "frm_d025a96ac0c6",
    "internal_name": "Intake Form",
    "object": "form",
    "updated_at": "2025-02-17T17:49:19Z"
    }