The monday.com form API lets you query a form’s configuration, appearance, and behavior. With it, you can programmatically access settings such as accessibility, visual styles, features, questions, and tags.

Each of the object types described below represents a specific aspect of a form. They can be queried as subfields on the form query or provide form metadata in mutations.

CreateFormTagInput

An object containing the form tag's properties.

❗️
Breaking change in 2026-10
The value field on CreateFormTagInput was removed in API version 2026-10. Remove value from any create_form_tag calls before migrating to 2026-10.

Field	Type	Description
name	`String!`	The tag's name.

CreateQuestionInput

An object containing the form question's properties.

Field	Description	Supported Fields
description `String`	The question's description.
options `[QuestionOptionInput!]`		label `String!`
required `Boolean`	Whether the question must be answered to submit the form.
settings `FormQuestionSettingsInput`	The question's type-specific settings.	checkedByDefault `Boolean` defaultCurrentDate `Boolean` display `FormQuestionSelectDisplay` includeTime `Boolean` locationAutofilled `Boolean` optionsOrder `FormQuestionSelectOrderByOptions` prefill `PrefillSettingsInput` prefixAutofilled `Boolean` prefixPredefined `PhonePrefixPredefinedInput` skipValidation `Boolean`
title `String!`	The question's title.
type `FormQuestionType!`	The question's type. Determines input behavior and validation.
visible `Boolean`	Whether the question is visible to respondents. Hidden questions remain in the form structure but aren't displayed to respondents. The default is `true`.
show_if_rules `JSON`	Conditional logic rules that determine whether the question is displayed, based on responses to other questions. Only available in versions `2026-07` and later.
existing_column_id `String`	The ID of an existing board column to link this question to. Only available in versions `2026-07` and later.
insert_after_question_id `String`	The ID of the question after which this new question should be inserted. Only available in versions `2026-07` and later.
page_block_id `String`	The ID of the page block this question belongs to. Only relevant for `PAGE_BLOCK`-type questions. Only available in versions `2026-07` and later.

QuestionOptionInput

An array of objects defining labels for choice-based option questions.

Field	Description
label `String!`	The option's label to display.
value `String`	The option's internal value. Only available in versions `2026-07` and later.
visible `Boolean`	Whether the option is visible to respondents. Only available in versions `2026-07` and later.

DehydratedFormResponse

An object containing the result of creating a new form via the API.

Field	Description
boardId `ID!`	The unique identifier of the board connected to the form.
token `String!`	The form's unique identifier.

DeleteFormTagInput

Defines the options for deleting a tag from a form via the API.

Field	Description
deleteAssociatedColumn `Boolean`	Whether the associated column should be deleted.

FormAccessibility

An object containing the form's accessibility options.

Field	Description
language `String`	The language code for the form's localization and interface text (e.g., "es", "en", "fr").
logoAltText `String`	The form's logo image alternative text description.

FormAppearance

An object containing the form’s overall visual appearance (e.g., background, layout, colors, typography).

Field	Description	Supported Fields
background `FormBackground`	An object containing the form's background appearance configuration.	type `FormBackgrounds` value `String`
hideBranding `Boolean!`	Whether monday.com branding is hidden.
layout `FormLayout`	An object containing the form's structure and presentation settings.	alignment `FormAlignment` direction `FormDirection` format `FormFormat`
logo `FormLogo`	An object containing the form's logo display configurations.	position `FormLogoPosition` size `FormLogoSize` url `String`
primaryColor `String`	The HEX color code of the primary theme color used in the form.
showProgressBar `Boolean!`	Whether an indicator showing the form's completion progress bar is displayed.
submitButton `FormSubmitButton`	An object containing the form's submit button configurations.	text `String`
text `FormText`	An object containing the form's typography and text styling configurations.	color `String` font `String` size `FormFontSize`

FormBackground

Configures the form’s background (e.g., color, image, or none).

Field	Description	Enum Values
type `FormBackgrounds`	The form's background type.	`Color` `Image` `None`
value `String`	The form's background value. For `Color`, it's a HEX color code. For `Image`, it's the image's URL.

FormLayout

Defines the form's layout, alignment, and format.

❗️
Breaking change in 2026-10
The format field and the FormFormat enum type were removed in API version 2026-10. Remove references to format and FormFormat before migrating to 2026-10.

Field	Description	Enum Values
alignment `FormAlignment`	The form's text and content alignment.	`Center` `FullLeft` `FullRight` `Left` `Right`
direction `FormDirection`	The form's reading direction.	`LtR` `Rtl`

FormLogo

Configures the form’s logo (e.g., placement, size, and image URL).

Field	Description	Enum Values
position `FormLogoPosition`	The form's logo placement.	`Auto` `Center` `Left` `Right`
size `FormLogoSize`	The form's logo size.	`ExtraLarge` (96px height) `Large` (72px height) `Medium` (40px height) `Small` (32px height)
url `String`	The URL for the form's logo.

FormSubmitButton

Defines the form's submit button text.

Field	Description
text `String`	The custom text displayed on the form's submit button.

FormText

Defines the form's typography configuration.

Field	Description	Enum Values
color `String`	The form's text HEX color code.
font `String`	The form's font family.
size `FormFontSize`	The form's base text size.	`Large` `Medium` `Small`

FormFeatures

An object containing form-level features like login requirements, response limits, and password protection.

Field	Description	Supported Fields
afterSubmissionView `FormAfterSubmissionView`	An object containing the form's post-submission configuration.	allowEditSubmission `Boolean!` allowResubmit `Boolean!` allowViewSubmission `Boolean!` description `String` redirectAfterSubmission `FormRedirectAfterSubmission` showSuccessImage `Boolean!` title `String`
closeDate `FormCloseDate`	An object containing the form's automatic closure configuration.	date `String` enabled `Boolean!`
draftSubmission `FormDraftSubmission`	An object containing the form's draft saving configuration.	enabled `Boolean!`
isInternal `Boolean!`	Whether the form is restricted to internal users only.
monday `FormMonday`	An object containing the board's settings for response handling.	includeNameQuestion `Boolean!` includeUpdateQuestion `Boolean!` itemGroupId `String` syncQuestionAndColumnsTitles `Boolean!`
password `FormPassword`	An object containing the form's password protection configuration.	enabled `Boolean!`
preSubmissionView `FormPreSubmissionView`	An object containing the form's welcome screen configuration.	description `String` enabled `Boolean!` startButton `FormStartButton` title `String`
reCaptchaChallenge `Boolean!`	Whether the form has reCAPTCHA verification enabled to prevent spam submissions.
requireLogin `FormRequireLogin`	An object containing the form's login requirement settings.	enabled `Boolean!` redirectToLogin `Boolean!`
responseLimit `FormResponseLimit`	An object containing the form's response limitation settings.	enabled `Boolean!` limit `Int`
shortenedLink `FormShortenedLink`	An object containing the form's shortened URL configuration.	enabled `Boolean!` url `String`

FormAfterSubmissionView

An object containing the form's post-submission settings.

Field	Description	Supported Fields
allowEditSubmission `Boolean!`	Whether users can edit their responses after submission.
allowResubmit `Boolean!`	Whether users can submit multiple responses to the same form.
allowViewSubmission `Boolean!`	Whether users can view their answers after submission.
description `String`	The text displayed after form submission.
redirectAfterSubmission `FormRedirectAfterSubmission`	An object containing the redirect configuration after form submission.	enabled `Boolean!` redirectUrl `String`
showSuccessImage `Boolean!`	Whether a success image appears after form submission.
title `String`	The title text displayed after form submission.

FormRedirectAfterSubmission

An object containing the form's post-submission redirect configuration.

Field	Description
enabled `Boolean!`	Whether responders are automatically redirected to a specified URL after form completion.
redirectUrl `String`	The URL where users are redirected after successfully completing the form.

FormCloseDate

An object containing the form's automatic closure configuration.

Field	Description
date `String`	The ISO 8601 timestamp when the form will automatically stop accepting responses.
enabled `Boolean!`	Whether the form automatically closes at a specified date and time.

FormDraftSubmission

An object containing the form's draft saving configuration.

Field	Description
enabled `Boolean!`	Whether users are allowed to save incomplete responses as drafts.

FormMonday

An object containing the form's board settings for response handling.

Field	Description
includeNameQuestion `Boolean!`	Whether a name question is added to the form. Corresponds to the item name column on the board.
includeUpdateQuestion `Boolean!`	Whether an update field is added to the form. Corresponds to the updates section of the associated item.
itemGroupId `String`	The board group ID where new items will be created from form responses.
syncQuestionAndColumnsTitles `Boolean!`	Whether the form question title syncs with the board column name.

FormPassword

An object containing the form's password protection configuration.

Field	Description
enabled `Boolean!`	Whether users must enter a password to access the form.

FormPreSubmissionView

An object containing the settings for the optional welcome screen shown before the form begins.

Field	Description	Supported Fields
description `String`	The text displayed on the welcome screen (e.g., extra context, instructions).
enabled `Boolean!`	Whether a welcome screen is displayed before starting the form.
startButton `FormStartButton`	An object containing the form's welcome screen start button configuration.	text `String`
title `String`	The title text displayed on the welcome screen.

FormRequireLogin

An object containing the form's login requirement settings.

Field	Description
enabled `Boolean!`	Whether the form requires users to log in before submitting responses.
redirectToLogin `Boolean!`	Whether unauthenticated users are automatically redirected to the login page.

FormResponseLimit

An object containing the form's response limitation settings.

Field	Description
enabled `Boolean!`	Whether the form's response limits are enabled.
limit `Int`	The maximum number of form responses allowed.

FormShortenedLink

An object containing the form's shortened URL configuration.

Field	Description
enabled `Boolean!`	Whether shortened URLs can be generated.
url `String`	The form's generated, shortened URL. Only available when shortened links are enabled.

FormQuestion

An array of objects containing the form's question content, in display order.

Field	Description	Supported Fields
description `String`	Optional text providing additional context, instructions, or examples for the question.
id `String!`	The question's unique identifier.
options `[FormQuestionOption!]`	The available options for choice-based questions. Each option defines a display label.	label `String!`
required `Boolean!`	Whether the question must be answered to submit the form.
settings `FormQuestionSettings`	An object containing question type-specific configurations.	checkedByDefault `Boolean` defaultCurrentDate `Boolean` display `FormQuestionSelectDisplay` includeTime `Boolean` limit `Int` locationAutofilled `Boolean` optionsOrder `FormQuestionSelectOrderByOptions` prefill `PrefillSettings` prefixAutofilled `Boolean` prefixPredefined `PhonePrefixPredefined` skipValidation `Boolean`
show_if_rules `JSON`	Conditional logic rules that determine whether the question is displayed, based on responses to other questions. Only available in versions `2026-07` and later. The camelCase alias `showIfRules` was removed in `2026-10` — use `show_if_rules` instead.
title `String!`	The question's title. Must be at least one character long.
type `FormQuestionType`	The question's type. Determines input behavior and validation.
visible `Boolean!`	Whether the question is visible to responders. Hidden questions remain in the form structure but aren't displayed to responders.

FormQuestionOption

An array containing the available options for choice-based questions.

Field	Description
label `String!`	The display text for individual option choices (in select-type questions).

FormQuestionSettings

An object containing the form's question type-specific configuration. If a type-specific setting is provided (e.g., includeTime), the form must contain a question of that type, or the mutation won't work.

Field	Description	Enum Values	Supported Fields
checkedByDefault `Boolean`	Whether the box should be checked by default. Only for boolean and checkbox questions.
defaultCurrentDate `Boolean`	Whether the current date is set as the default value. Only for date questions.
display `FormQuestionSelectDisplay`	The display options for select-type questions. Only for single or multiple select questions.	`Dropdown` `Horizontal` `Vertical`
includeTime `Boolean`	Whether the time selection (hours and minutes) is included with the date selector. If `false`, only the date is included. Only for date questions.
limit `Int`	The maximum rating value that can be selected. Only for rating questions.
locationAutofilled `Boolean`	Whether the responder's location is automatically detected and filled. Uses the browser's geolocation services. Requires user permission. Only for location questions.
optionsOrder `FormQuestionSelectOrderByOptions`	The ordering options for select questions. Only for single or multiple select questions.	`Alphabetical` `Custom` `Random`
prefill `PrefillSettings`	The configuration for automatically populating question values.		enabled `Boolean!` lookup `String!` source `FormQuestionPrefillSources`
prefixAutofilled `Boolean`	Whether the phone country prefix is automatically detected and filled. Uses the responder's geographic location or browser settings. Only for phone questions.
prefixPredefined `PhonePrefixPredefined`	The configuration for setting a predefined phone country prefix that will be pre-selected for responders. Only for phone questions.		enabled `Boolean!` prefix `String`
skipValidation `Boolean`	Whether URL format validation is skipped, allowing any text input. Only for link/URL questions.

PhonePrefixPredefined

Defines the configuration for pre-selecting a phone country prefix for responders.

Field	Description
enabled `Boolean!`	Whether a pre-defined phone country prefix is enabled for phone number questions. If `true`, the specified prefix will be pre-selected.
prefix `String`	The predefined phone country prefix in capital letters (e.g., "US", "UK").

PrefillSettings

Defines the configuration for auto-populating question values.

Field	Description	Enum Values
enabled `Boolean!`	Whether the question's prefill functionality is enabled. If `true`, the values will be auto-populated from the specified source.
lookup `String!`	The field or parameter name to lookup from the prefill source. For `Account` sources, this is a user property like name or email. For `QueryParam` sources, this is the parameter name that's set in the URL.
source `FormQuestionPrefillSources`	The sources for prefilling question values.	`Account` `QueryParam`

FormQuestionType

Supported enum values for FormQuestionType.


Boolean	ConnectedBoards	Country	Date	DateRange	Email	File
Link	Location	LongText	MultiSelect	Name	Number	People
Phone	Rating	ShortText	Signature	SingleSelect	Subitems	Updates

The following values are available in API version 2026-07 and later:

`HOUR`	`DISPLAY_TEXT`	`PAGE_BLOCK`

FormTag

An array of tracking tags for categorization and analytics.

query {
  form(formToken: "YOUR_FORM_TOKEN") {
    tags {
      id
      name
      value
      columnId
    }
  }
}

{
  "data": {
    "form": {
      "tags": [
        {
          "id": "8f2a91c4-6d9a-49c3-bf12-93b4f019d7e1",
          "columnId": "short_textxjwe48lm",
          "value": "ENGLISH",
          "name": "LANGUAGE"
        }
      ]
    }
  },
  "extensions": {
    "request_id": "2d74c9f0-5b21-4e68-a123-8f91bb47e0cd"
  }
}

❗️
Breaking change in 2026-10
The value field on FormTag was removed in API version 2026-10. Remove any queries requesting value from form tags before migrating to 2026-10.

Field	Description
columnId `String!`	The unique identifier of the column the tag is associated with.
id `String!`	The tag's unique identifier.
name `String!`	The tag's name.

ResponseForm

An object containing the form's accessibility, appearance, features, questions, and tags.

Field	Description	Supported Subfields
accessibility `FormAccessibility`	The form's accessibility settings.	language `String` logoAltText `String`
active `Boolean!`	Whether the form is visible and accepting responses.
appearance `FormAppearance`	The form's visual style settings.	background `FormBackground` hideBranding `Boolean!` layout `FormLayout` logo `FormLogo` primaryColor `String` showProgressBar `Boolean!` submitButton `FormSubmitButton` text `FormText`
createWithAi `Boolean!`	Whether the form was originally created with monday.com’s AI-assisted form builder.
description `String`	The optional form description, displayed below the title.
features `FormFeatures`	The form's toggles and feature settings.	afterSubmissionView `FormAfterSubmissionView` closeDate `FormCloseDate` draftSubmission `FormDraftSubmission` isInternal `Boolean!` monday `FormMonday` password `FormPassword` preSubmissionView `FormPreSubmissionView` reCaptchaChallenge `Boolean!` requireLogin `FormRequireLogin` responseLimit `FormResponseLimit` shortenedLink `FormShortenedLink`
id `Int!`	The form's unique board view identifier.
isAnonymous `Boolean!`	Whether responses are collected anonymously.
ownerId `Int`	The user ID of the form's owner/creator.
questions `[FormQuestion!]`	An array of question objects that make up the form, in display order.	description `String` id `String!` options `[FormQuestionOption!]` required `Boolean!` settings `FormQuestionSettings` show_if_rules `JSON` title `String!` type `FormQuestionType` visible `Boolean!`
tags `[FormTag!]`	Tracking tags for categorization and analytics.	columnId `String!` id `String!` name `String!` value `String`
title `String!`	Title displayed at the top of the form.
token `String!`	The form's string-based unique token. Used in API queries and mutations.
type `String`	The form's type.

SetFormPasswordInput

An object defining the form's password.

Field	Type	Description
password	`String!`	The form's password.

UpdateFormInput

An object defining the form's properties to update.

Field	Description	Supported Fields
description `String`	The form's updated description.
questions `[QuestionOrderInput!]`	An ordered array of all question IDs in the form. Must include every existing question ID, and their order determines the display order of the questions.	id `String!` page_block_id `String` (version `2026-07` and later)
title `String`	The form's updated title. Must be at least one character long.

UpdateFormSettingsInput

An object defining the form settings inputs to update.

Field	Description	Supported Fields
accessibility `FormAccessibilityInput`	The form's updated accessibility settings.	language `String` logoAltText `String`
appearance `FormAppearanceInput`	The form's updated visual style settings.	background `FormBackgroundInput` hideBranding `Boolean` layout `FormLayoutInput` logo `FormLogoInput` primaryColor `String` showProgressBar `Boolean` submitButton `FormSubmitButtonInput` text `FormTextInput` is_anonymous `Boolean` (version `2026-07` and later)
features `FormFeaturesInput`	The form's updated toggles and feature settings.	afterSubmissionView `FormAfterSubmissionViewInput` closeDate `FormCloseDateInput` draftSubmission `FormDraftSubmissionInput` monday `FormMondayInput` password `FormPasswordInput` preSubmissionView `FormPreSubmissionViewInput` reCaptchaChallenge `Boolean` requireLogin `FormRequireLoginInput` responseLimit `FormResponseLimitInput` ai_translate `Boolean` (version `2026-07` and later)

FormAccessibilityInput

An object containing the updated input for the form's updated accessibility options.

Field	Description
language `String`	The language code for the form's localization and interface text (e.g., "es", "en", "fr").
logoAltText `String`	The form's logo image alternative text description.

FormAppearanceInput

An object containing the updated input for the form’s overall visual appearance (e.g., background, layout, colors, typography).

Field	Description	Supported Fields
background `FormBackgroundInput`	An object containing the form's updated background appearance configuration input.	type `FormBackgrounds!` value `String`
hideBranding `Boolean`	Whether monday.com branding is hidden.
layout `FormLayoutInput`	An object containing the form's updated structure and presentation settings input.	alignment `FormAlignment` direction `FormDirection` format `FormFormat`
logo `FormLogoInput`	An object containing the form's updated logo display configuration input.	position `FormLogoPosition` size `FormLogoSize` url `String`
primaryColor `String`	The HEX color code of the primary theme color used in the form.
showProgressBar `Boolean`	Whether an indicator showing the form's updated completion progress bar is displayed.
submitButton `FormSubmitButtonInput`	An object containing the form's updated submit button configuration input.	text `String`
text `FormTextInput`	An object containing the form's updated typography and text styling configuration input.	color `String` font `String` size `FormFontSize`

FormBackgroundInput

Configures the form’s updated background input (e.g., color, image, or none).

Field	Description	Enum Values
type `FormBackgrounds!`	The form's background type.	`Color` `Image` `None`
value `String`	The form's background value. For `Color`, it's a HEX color code. For `Image`, it's the image's URL.

FormLayoutInput

Defines the form's updated layout, alignment, and format input.

❗️
Breaking change in 2026-10
The format field was removed in API version 2026-10. Remove format from FormLayoutInput inputs before migrating to 2026-10.

Field	Description	Enum Values
alignment `FormAlignment`	The form's text and content alignment.	`Center` `FullLeft` `FullRight` `Left` `Right`
direction `FormDirection`	The form's reading direction.	`LtR` `Rtl`

FormLogoInput

Configures the form’s updated logo input (e.g., placement, size, and image URL).

Field	Description	Enum Values
position `FormLogoPosition`	The form's logo placement.	`Auto` `Center` `Left` `Right`
size `FormLogoSize`	The form's logo size.	`ExtraLarge` (96px height) `Large` (72px height) `Medium` (40px height) `Small` (32px height)

FormSubmitButtonInput

Defines the form's updated submit button text.

Field	Description
text `String`	The custom text displayed on the form's submit button.

FormTextInput

Defines the form's updated typography configuration.

Field	Description	Enum Values
color `String`	The form's text HEX color code.
font `String`	The form's font family.
size `FormFontSize`	The form's base text size.	`Large` `Medium` `Small`

FormFeaturesInput

An object containing the input for form-level features like login requirements, response limits, and password protection.

Field	Description	Supported Fields
afterSubmissionView `FormAfterSubmissionViewInput`	An object containing the form's updated post-submission configuration input.	allowEditSubmission `Boolean` allowResubmit `Boolean` allowViewSubmission `Boolean` description `String` redirectAfterSubmission `FormRedirectAfterSubmissionInput` showSuccessImage `Boolean` title `String`
closeDate `FormCloseDateInput`	An object containing the form's updated automatic closure configuration input.	date `String` enabled `Boolean`
draftSubmission `FormDraftSubmissionInput`	An object containing the form's updated draft saving configuration input.	enabled `Boolean`
monday `FormMondayInput`	An object containing the updated board's settings input for response handling.	includeNameQuestion `Boolean` includeUpdateQuestion `Boolean` itemGroupId `String` syncQuestionAndColumnsTitles `Boolean`
password `FormPasswordInput`	An object containing the form's updated password protection configuration input.	enabled `Boolean`
preSubmissionView `FormPreSubmissionViewInput`	An object containing the form's updated welcome screen configuration input.	description `String` enabled `Boolean` startButton `FormStartButtonInput` title `String`
reCaptchaChallenge `Boolean`	Whether the form has reCAPTCHA verification enabled to prevent spam submissions.
requireLogin `FormRequireLoginInput`	An object containing the form's updated login requirement settings input.	enabled `Boolean` redirectToLogin `Boolean`
responseLimit `FormResponseLimitInput`	An object containing the form's updated response limitation settings input.	enabled `Boolean` limit `Int`

FormAfterSubmissionViewInput

An object containing the form's updated post-submission settings.

Field	Description	Supported Fields
allowEditSubmission `Boolean`	Whether users can edit their responses after submission.
allowResubmit `Boolean`	Whether users can submit multiple responses to the same form.
allowViewSubmission `Boolean`	Whether users can view their answers after submission.
description `String`	The text displayed after form submission.
redirectAfterSubmission `FormRedirectAfterSubmissionInput`	An object containing the redirect configuration after form submission.	enabled `Boolean` redirectUrl `String`
showSuccessImage `Boolean`	Whether a success image appears after form submission.
title `String`	The title text displayed after form submission.

FormRedirectAfterSubmissionInput

An object containing the form's updated post-submission redirect configuration input.

Field	Description
enabled `Boolean`	Whether responders are automatically redirected to a specified URL after form completion.
redirectUrl `String`	The URL where users are redirected after successfully completing the form.

FormCloseDateInput

An object containing the form's updated automatic closure configuration.

Field	Description
date `String`	The ISO 8601 timestamp when the form will automatically stop accepting responses.
enabled `Boolean`	Whether the form automatically closes at a specified date and time.

FormDraftSubmissionInput

An object containing the form's updated draft saving configuration input.

Field	Description
enabled `Boolean`	Whether users are allowed to save incomplete responses as drafts.

FormMondayInput

An object containing the form's updated board settings input for response handling.

Field	Description
includeNameQuestion `Boolean`	Whether a name question is added to the form. Corresponds to the item name column on the board.
includeUpdateQuestion `Boolean`	Whether an update field is added to the form. Corresponds to the updates section of the associated item.
itemGroupId `String`	The board group ID where new items will be created from form responses.
syncQuestionAndColumnsTitles `Boolean`	Whether the form question title syncs with the board column name.
allow_create_item `Boolean`	Whether submitting the form creates a new item on the connected board. Only available in versions `2026-07` and later.

FormPasswordInput

An object containing the form's updated password protection configuration input.

Field	Description
enabled `Boolean`	Whether users must enter a password to access the form. This can only be used to disable password protection. To enable it, use the `set_form_password` mutation.

FormPreSubmissionViewInput

An object containing the updated settings input for the optional welcome screen shown before the form begins.

Field	Description	Supported Fields
description `String`	The text displayed on the welcome screen.
enabled `Boolean`	Whether a welcome screen is displayed before starting the form.
startButton `FormStartButtonInput`	An object containing the form's welcome screen start button configuration input.	text `String`
title `String`	The title text displayed on the welcome screen.

FormRequireLoginInput

An object containing the form's updated login requirement settings input.

Field	Description
enabled `Boolean`	Whether the form requires users to log in before submitting responses.
redirectToLogin `Boolean`	Whether unauthenticated users are automatically redirected to the login page.

FormResponseLimitInput

An object containing the form's updated response limitation settings input.

Field	Description
enabled `Boolean`	Whether the form's response limits are enabled.
limit `Int`	The maximum number of form responses allowed.

UpdateFormTagInput

❗️
Removed in 2026-10
The UpdateFormTagInput type and the update_form_tag mutation were removed in API version 2026-10. Remove any usage before migrating.

An object containing the question's updated tags (removed in 2026-10).

Field	Type	Description
value	`String`	The tag's updated value.

UpdateQuestionInput

An object containing the question's updated properties.

Field	Description	Supported Fields
description `String`	The question's updated description.
required `Boolean`	Whether the question must be answered to submit the form.
settings `FormQuestionSettingsInput`	The question's updated type-specific settings.	checkedByDefault `Boolean` defaultCurrentDate `Boolean` display `FormQuestionSelectDisplay` includeTime `Boolean` locationAutofilled `Boolean` optionsOrder `FormQuestionSelectOrderByOptions` prefill `PrefillSettingsInput` prefixAutofilled `Boolean` prefixPredefined `PhonePrefixPredefinedInput` skipValidation `Boolean`
title `String`	The question's updated title.
type `FormQuestionType!`	The question's updated type that determines input behavior and validation. You can't pass a new question type—it must match the type of the existing question.
visible `Boolean`	Whether the question is visible to respondents. Hidden questions remain in the form structure but aren't displayed to respondents.
show_if_rules `JSON`	Updated conditional logic rules for this question. Only available in versions `2026-07` and later.
options `[QuestionOptionInput!]`	The updated options for choice-based questions. Only available in versions `2026-07` and later.

FormQuestionSettingsInput

An object containing the question's updated type-specific configuration. If a type-specific setting is provided (e.g., includeTime), the form must contain a question of that type, or the mutation won't work.

Field	Description	Enum Values	Supported Fields
checkedByDefault `Boolean`	Whether the box should be checked by default. Only for boolean and checkbox questions.
defaultCurrentDate `Boolean`	Whether the current date is set as the default value. Only for date questions.
display `FormQuestionSelectDisplay`	The display options for select-type questions. Only for single or multiple select questions.	`Dropdown` `Horizontal` `Vertical`
includeTime `Boolean`	Whether the time selection (hours and minutes) is included with the date selector. If `false`, only the date is included. Only for date questions.
locationAutofilled `Boolean`	Whether the responder's location is automatically detected and filled. Uses the browser's geolocation services. Requires user permission. Only for location questions.
optionsOrder `FormQuestionSelectOrderByOptions`	The ordering options for select questions. Only for single or multiple select questions.	`Alphabetical` `Custom` `Random`
prefill `PrefillSettingsInput`	The configuration for automatically populating question values.		enabled `Boolean!` lookup `String` source `FormQuestionPrefillSources`
prefixAutofilled `Boolean`	Whether the phone country prefix is automatically detected and filled. Uses the responder's geographic location or browser settings. Only for phone questions.
prefixPredefined `PhonePrefixPredefinedInput`	The configuration for setting a predefined phone country prefix that will be pre-selected for responders. Only for phone questions.		enabled `Boolean!` prefix `String`
skipValidation `Boolean`	Whether URL format validation is skipped, allowing any text input. Only for link/URL questions.
label_limit_count_enabled `Boolean`	Whether a character count limit is displayed for text input questions. Only available in versions `2026-07` and later.
default_answer `String`	A default answer pre-filled when the question is displayed. Only available in versions `2026-07` and later.

PhonePrefixPredefinedInput

Defines the configuration for pre-selecting a phone country prefix for responders.

Field	Description
enabled `Boolean!`	Whether a pre-defined phone country prefix is enabled for phone number questions. If `true`, the specified prefix will be pre-selected.
prefix `String`	The predefined phone country prefix in capital letters (e.g., "US", "UK").

PrefillSettingsInput

Defines the configuration for auto-populating question values.

Field	Description	Enum Values
enabled `Boolean!`	Whether the question's prefill functionality is enabled. If `true`, the values will be auto-populated from the specified source.
lookup `String`	The field or parameter name to look up from the prefill source. For `Account` sources, this is a user property like name or email. For `QueryParam` sources, this is the parameter name that's set in the URL.
source `FormQuestionPrefillSources`	The sources for prefilling question values.	`Account` `QueryParam`

CreateFormTagInput

Breaking change in 2026-10

CreateQuestionInput

QuestionOptionInput

DehydratedFormResponse

DeleteFormTagInput

FormAccessibility

FormAppearance

FormBackground

FormLayout

Breaking change in 2026-10

FormLogo

FormSubmitButton

FormText

FormFeatures

FormAfterSubmissionView

FormRedirectAfterSubmission

FormCloseDate

FormDraftSubmission

FormMonday

FormPassword

FormPreSubmissionView

FormRequireLogin

FormResponseLimit

FormShortenedLink

FormQuestion

FormQuestionOption

FormQuestionSettings

PhonePrefixPredefined

PrefillSettings

FormQuestionType

FormTag

Breaking change in 2026-10

ResponseForm

SetFormPasswordInput

UpdateFormInput

UpdateFormSettingsInput

FormAccessibilityInput

FormAppearanceInput

FormBackgroundInput

FormLayoutInput

Breaking change in 2026-10

FormLogoInput

FormSubmitButtonInput

FormTextInput

FormFeaturesInput

FormAfterSubmissionViewInput

FormRedirectAfterSubmissionInput

FormCloseDateInput

FormDraftSubmissionInput

FormMondayInput

FormPasswordInput

FormPreSubmissionViewInput

FormRequireLoginInput

FormResponseLimitInput

UpdateFormTagInput

Removed in 2026-10

UpdateQuestionInput

FormQuestionSettingsInput

PhonePrefixPredefinedInput

PrefillSettingsInput

What’s Next

What’s Next

Breaking change in `2026-10`

Breaking change in `2026-10`

Breaking change in `2026-10`

Breaking change in `2026-10`

Removed in `2026-10`