Dokumentacja dla programistów

Inne typy

Aktualizacja 2026-09-06

API form monday.com umożliwia pobieranie konfiguracji formularza, jego wyglądu i działania. Pozwala programowo uzyskać dostęp do ustawień, takich jak dostępność, style wizualne, funkcje, pytania i tagi.

Każdy z opisanych poniżej typów obiektów reprezentuje określony aspekt formularza. Można pobierać je jako pola podrzędne zapytania form lub używać do przekazywania metadanych formularza w mutacjach.

CreateFormTagInput

Obiekt zawierający właściwości tagu formularza.

❗️ Zmiana powodująca niezgodność wsteczną w wersji 2026-10

Pole value w typie CreateFormTagInput zostało usunięte w wersji API 2026-10. Przed przejściem na wersję 2026-10 usuń pole value ze wszystkich wywołań create_form_tag.

Field Type Description
name String! Nazwa tagu.

CreateQuestionInput

Obiekt zawierający właściwości pytania w formularzu.

Pole Opis Obsługiwane pola
description String Opis pytania.
options [QuestionOptionInput!] label String!
required Boolean Określa, czy odpowiedź na pytanie jest wymagana do wysłania formularza.
settings FormQuestionSettingsInput Ustawienia właściwe dla typu pytania. checkedByDefault Boolean
defaultCurrentDate Boolean
display FormQuestionSelectDisplay
includeTime Boolean
locationAutofilled Boolean
optionsOrder FormQuestionSelectOrderByOptions
prefill PrefillSettingsInput
prefixAutofilled Boolean
prefixPredefined PhonePrefixPredefinedInput
skipValidation Boolean
title String! Tytuł pytania.
type FormQuestionType! Typ pytania. Określa sposób wprowadzania danych i ich walidację.
visible Boolean Określa, czy pytanie jest widoczne dla respondentów. Ukryte pytania pozostają w strukturze formularza, ale nie są wyświetlane respondentom. Wartością domyślną jest true.
show_if_rules JSON Reguły logiki warunkowej określające, czy pytanie jest wyświetlane na podstawie odpowiedzi na inne pytania. Dostępne tylko w wersji 2026-07 i nowszych.
existing_column_id String Identyfikator istniejącej kolumny tablicy, z którą ma być powiązane to pytanie. Dostępne tylko w wersji 2026-07 i nowszych.
insert_after_question_id String Identyfikator pytania, po którym ma zostać dodane nowe pytanie. Dostępne tylko w wersji 2026-07 i nowszych.
page_block_id String Identyfikator bloku strony, do którego należy to pytanie. Dotyczy tylko pytań typu PAGE_BLOCK. Dostępne tylko w wersji 2026-07 i nowszych.

QuestionOptionInput

Tablica obiektów definiujących etykiety opcji w pytaniach wyboru.

Pole Opis
label String! Etykieta wyświetlana przy danej opcji.
value String Wewnętrzna wartość opcji. Dostępne tylko w wersji 2026-07 i nowszych.
visible Boolean Określa, czy opcja jest widoczna dla respondentów. Dostępne tylko w wersji 2026-07 i nowszych.

DehydratedFormResponse

Obiekt zawierający wynik utworzenia nowego formularza za pomocą API.

Pole Opis
boardId ID! Unikatowy identyfikator tablicy połączonej z formularzem.
token String! Unikatowy identyfikator formularza.

DeleteFormTagInput

Definiuje opcje usuwania tagu z formularza za pomocą API.

Pole Opis
deleteAssociatedColumn Boolean Określa, czy powiązana kolumna ma zostać usunięta.

FormAccessibility

Obiekt zawierający ustawienia dostępności formularza.

Pole Opis
language String Kod języka określający lokalizację formularza i tekst interfejsu (np. „es”, „en”, „fr”).
logoAltText String Tekst alternatywny opisujący logo formularza.

FormAppearance

Obiekt zawierający ogólny wygląd formularza (np. tło, układ, kolory i typografię).

Pole Opis Obsługiwane pola
background FormBackground Obiekt zawierający konfigurację tła formularza. type FormBackgrounds
value String
hideBranding Boolean! Określa, czy branding monday.com jest ukryty.
layout FormLayout Obiekt zawierający ustawienia struktury i prezentacji formularza. alignment FormAlignment
direction FormDirection
format FormFormat
logo FormLogo Obiekt zawierający ustawienia wyświetlania logo formularza. position FormLogoPosition
size FormLogoSize
url String
primaryColor String Kod koloru HEX głównego koloru motywu używanego w formularzu.
showProgressBar Boolean! Określa, czy wyświetlany jest wskaźnik postępu wypełniania formularza.
submitButton FormSubmitButton Obiekt zawierający konfigurację przycisku wysyłania formularza. text String
text FormText Obiekt zawierający ustawienia typografii i stylów tekstu formularza. color String
font String
size FormFontSize

FormBackground

Konfiguruje tło formularza (np. kolor, obraz lub jego brak).

Pole Opis Wartości typu enum
type FormBackgrounds Typ tła formularza. Color
Image
None
value String

Wartość tła formularza.

  • Dla Color jest to kod koloru HEX.
  • Dla Image jest to adres URL obrazu.

FormLayout

Definiuje układ, wyrównanie i format formularza.

❗️ Zmiana powodująca niezgodność wsteczną w wersji 2026-10

Pole format i typ enum FormFormat zostały usunięte w wersji API 2026-10. Przed przejściem na wersję 2026-10 usuń odwołania do format i FormFormat.

Pole Opis Wartości typu enum
alignment FormAlignment Wyrównanie tekstu i zawartości formularza. Center
FullLeft
FullRight
Left
Right
direction FormDirection Kierunek czytania formularza. LtR
Rtl

FormLogo

Konfiguruje logo formularza (np. jego położenie, rozmiar i adres URL obrazu).

Pole Opis Wartości typu enum
position FormLogoPosition Położenie logo formularza. Auto
Center
Left
Right
size FormLogoSize Rozmiar logo formularza. ExtraLarge (wysokość 96px)
Large (wysokość 72px)
Medium (wysokość 40px)
Small (wysokość 32px)
url String Adres URL logo formularza.

FormSubmitButton

Definiuje tekst przycisku wysyłania formularza.

Pole Opis
text String Niestandardowy tekst wyświetlany na przycisku wysyłania formularza.

FormText

Definiuje konfigurację typografii formularza.

Pole Opis Wartości typu enum
color String Kod koloru HEX tekstu formularza.
font String Krój pisma używany w formularzu.
size FormFontSize Podstawowy rozmiar tekstu formularza. Large
Medium
Small

FormFeatures

Obiekt zawierający funkcje dostępne na poziomie formularza, takie jak wymóg logowania, limity odpowiedzi i ochrona hasłem.

Pole Opis Obsługiwane pola
afterSubmissionView FormAfterSubmissionView Obiekt zawierający konfigurację formularza po jego wysłaniu. allowEditSubmission Boolean!
allowResubmit Boolean!
allowViewSubmission Boolean!
description String
redirectAfterSubmission FormRedirectAfterSubmission
showSuccessImage Boolean!
title String
closeDate FormCloseDate Obiekt zawierający konfigurację automatycznego zamknięcia formularza. date String
enabled Boolean!
draftSubmission FormDraftSubmission Obiekt zawierający konfigurację zapisywania wersji roboczych formularza. enabled Boolean!
isInternal Boolean! Określa, czy formularz jest dostępny wyłącznie dla użytkowników wewnętrznych.
monday FormMonday Obiekt zawierający ustawienia tablicy dotyczące obsługi odpowiedzi. includeNameQuestion Boolean!
includeUpdateQuestion Boolean!
itemGroupId String
syncQuestionAndColumnsTitles Boolean!
password FormPassword Obiekt zawierający konfigurację ochrony formularza hasłem. enabled Boolean!
preSubmissionView FormPreSubmissionView Obiekt zawierający konfigurację ekranu powitalnego. description String
enabled Boolean!
startButton FormStartButton
title String
reCaptchaChallenge Boolean! Określa, czy w formularzu włączono weryfikację reCAPTCHA, aby zapobiec wysyłaniu spamu.
requireLogin FormRequireLogin Obiekt zawierający ustawienia wymogu logowania do formularza. enabled Boolean!
redirectToLogin Boolean!
responseLimit FormResponseLimit Obiekt zawierający ustawienia limitu odpowiedzi. enabled Boolean!
limit Int
shortenedLink FormShortenedLink Obiekt zawierający konfigurację skróconego adresu URL formularza. enabled Boolean!
url String

FormAfterSubmissionView

Obiekt zawierający ustawienia formularza po jego wysłaniu.

Pole Opis Obsługiwane pola
allowEditSubmission Boolean! Określa, czy użytkownicy mogą edytować swoje odpowiedzi po wysłaniu formularza.
allowResubmit Boolean! Określa, czy użytkownicy mogą wielokrotnie wysyłać odpowiedzi w tym samym formularzu.
allowViewSubmission Boolean! Określa, czy użytkownicy mogą wyświetlić swoje odpowiedzi po wysłaniu formularza.
description String Tekst wyświetlany po wysłaniu formularza.
redirectAfterSubmission FormRedirectAfterSubmission Obiekt zawierający konfigurację przekierowania po wysłaniu formularza. enabled Boolean!
redirectUrl String
showSuccessImage Boolean! Określa, czy po wysłaniu formularza wyświetlany jest obraz potwierdzający powodzenie.
title String Tytuł wyświetlany po wysłaniu formularza.

FormRedirectAfterSubmission

Obiekt zawierający konfigurację przekierowania po wysłaniu formularza.

Pole Opis
enabled Boolean! Określa, czy po wypełnieniu formularza respondenci są automatycznie przekierowywani pod wskazany adres URL.
redirectUrl String Adres URL, pod który użytkownicy są przekierowywani po pomyślnym wypełnieniu formularza.

FormCloseDate

Obiekt zawierający konfigurację automatycznego zamknięcia formularza.

Pole Opis
date String Znacznik czasu ISO 8601 określający, kiedy formularz automatycznie przestanie przyjmować odpowiedzi.
enabled Boolean! Określa, czy formularz jest automatycznie zamykany w określonym dniu i o określonej godzinie.

FormDraftSubmission

Obiekt zawierający konfigurację zapisywania wersji roboczych formularza.

Pole Opis
enabled Boolean! Określa, czy użytkownicy mogą zapisywać nieukończone odpowiedzi jako wersje robocze.

FormMonday

Obiekt zawierający ustawienia tablicy dotyczące obsługi odpowiedzi w formularzu.

Pole Opis
includeNameQuestion Boolean! Określa, czy do formularza dodawane jest pytanie o imię i nazwisko. Odpowiada ono kolumnie nazwy elementu na tablicy.
includeUpdateQuestion Boolean! Określa, czy do formularza dodawane jest pole aktualizacji. Odpowiada ono sekcji aktualizacji powiązanego elementu.
itemGroupId String Identyfikator grupy na tablicy, w której na podstawie odpowiedzi z formularza zostaną utworzone nowe elementy.
syncQuestionAndColumnsTitles Boolean! Określa, czy tytuł pytania w formularzu jest synchronizowany z nazwą kolumny na tablicy.

FormPassword

Obiekt zawierający konfigurację ochrony formularza hasłem.

Pole Opis
enabled Boolean! Określa, czy użytkownicy muszą podać hasło, aby uzyskać dostęp do formularza.

FormPreSubmissionView

Obiekt zawierający ustawienia opcjonalnego ekranu powitalnego wyświetlanego przed rozpoczęciem formularza.

Pole Opis Obsługiwane pola
description String Tekst wyświetlany na ekranie powitalnym (np. dodatkowe informacje lub instrukcje).
enabled Boolean! Określa, czy przed rozpoczęciem formularza wyświetlany jest ekran powitalny.
startButton FormStartButton Obiekt zawierający konfigurację przycisku rozpoczęcia na ekranie powitalnym formularza. text String
title String Tytuł wyświetlany na ekranie powitalnym.

FormRequireLogin

Obiekt zawierający ustawienia wymogu logowania do formularza.

Pole Opis
enabled Boolean! Określa, czy użytkownicy muszą się zalogować przed wysłaniem odpowiedzi.
redirectToLogin Boolean! Określa, czy nieuwierzytelnieni użytkownicy są automatycznie przekierowywani na stronę logowania.

FormResponseLimit

Obiekt zawierający ustawienia limitu odpowiedzi.

Pole Opis
enabled Boolean! Określa, czy limity odpowiedzi w formularzu są włączone.
limit Int Maksymalna liczba odpowiedzi, które można przesłać w formularzu.

FormShortenedLink

Obiekt zawierający konfigurację skróconego adresu URL formularza.

Pole Opis
enabled Boolean! Określa, czy można generować skrócone adresy URL.
url String Wygenerowany, skrócony adres URL formularza. Dostępny tylko wtedy, gdy skrócone linki są włączone.

FormQuestion

Tablica obiektów zawierających treść pytań w formularzu w kolejności ich wyświetlania.

Pole Opis Obsługiwane pola
description String Opcjonalny tekst zawierający dodatkowe informacje, instrukcje lub przykłady dotyczące pytania.
id String! Unikatowy identyfikator pytania.
options [FormQuestionOption!] Opcje dostępne w pytaniach wyboru. Każda opcja określa etykietę wyświetlaną użytkownikowi. label String!
required Boolean! Określa, czy odpowiedź na pytanie jest wymagana do wysłania formularza.
settings FormQuestionSettings Obiekt zawierający konfigurację właściwą dla typu pytania. 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 Reguły logiki warunkowej określające, czy pytanie jest wyświetlane na podstawie odpowiedzi na inne pytania. Dostępne tylko w wersji 2026-07 i nowszych. Aliasa camelCase showIfRules usunięto w wersji 2026-10 - użyj zamiast niego show_if_rules.
title String! Tytuł pytania. Musi zawierać co najmniej jeden znak.
type FormQuestionType Typ pytania. Określa sposób wprowadzania danych i ich walidację.
visible Boolean! Określa, czy pytanie jest widoczne dla respondentów. Ukryte pytania pozostają w strukturze formularza, ale nie są wyświetlane respondentom.

FormQuestionOption

Tablica zawierająca dostępne opcje w pytaniach wyboru.

Pole Opis
label String! Tekst wyświetlany przy poszczególnych opcjach wyboru (w pytaniach typu select).

FormQuestionSettings

Obiekt zawierający konfigurację właściwą dla typu pytania w formularzu. Jeśli podasz ustawienie właściwe dla konkretnego typu (np. includeTime), formularz musi zawierać pytanie tego typu. W przeciwnym razie mutacja nie zadziała.

Pole Opis Wartości typu enum Obsługiwane pola
checkedByDefault Boolean Określa, czy pole wyboru ma być domyślnie zaznaczone. Dotyczy tylko pytań typu Boolean i Checkbox.
defaultCurrentDate Boolean Określa, czy bieżąca data jest ustawiana jako wartość domyślna. Dotyczy tylko pytań dotyczących daty.
display FormQuestionSelectDisplay Opcje wyświetlania pytań typu select. Dotyczy tylko pytań jednokrotnego lub wielokrotnego wyboru. Dropdown
Horizontal
Vertical
includeTime Boolean Określa, czy selektor daty zawiera wybór godziny i minut. Jeśli wartość to false, uwzględniana jest tylko data. Dotyczy tylko pytań dotyczących daty.
limit Int Maksymalna wartość oceny, którą można wybrać. Dotyczy tylko pytań dotyczących oceny.
locationAutofilled Boolean Określa, czy lokalizacja respondenta jest automatycznie wykrywana i wstawiana. Wykorzystywane są do tego usługi geolokalizacyjne przeglądarki. Wymagana jest zgoda użytkownika. Dotyczy tylko pytań dotyczących lokalizacji.
optionsOrder FormQuestionSelectOrderByOptions Opcje sortowania odpowiedzi w pytaniach typu select. Dotyczy tylko pytań jednokrotnego lub wielokrotnego wyboru. Alphabetical
Custom
Random
prefill PrefillSettings Konfiguracja automatycznego wypełniania wartości pytań. enabled Boolean!
lookup String!
source FormQuestionPrefillSources
prefixAutofilled Boolean Określa, czy prefiks kraju numeru telefonu jest automatycznie wykrywany i wstawiany. Wykorzystywana jest do tego lokalizacja respondenta lub ustawienia przeglądarki. Dotyczy tylko pytań dotyczących numeru telefonu.
prefixPredefined PhonePrefixPredefined Konfiguracja wstępnie zdefiniowanego prefiksu kraju dla numeru telefonu, który zostanie wstępnie wybrany dla respondentów. Dotyczy tylko pytań dotyczących numeru telefonu. enabled Boolean!
prefix String
skipValidation Boolean Określa, czy walidacja formatu adresu URL jest pomijana, co pozwala wprowadzić dowolny tekst. Dotyczy tylko pytań dotyczących linku lub adresu URL.

PhonePrefixPredefined

Definiuje konfigurację wstępnego wyboru prefiksu kraju dla numeru telefonu respondenta.

Pole Opis
enabled Boolean! Określa, czy dla pytań o numer telefonu włączono wstępnie zdefiniowany prefiks kraju. Jeśli wartość to true, wskazany prefiks zostanie wstępnie wybrany.
prefix String Wstępnie zdefiniowany prefiks kraju zapisany wielkimi literami (np. „US”, „UK”).

PrefillSettings

Definiuje konfigurację automatycznego wypełniania wartości pytań.

Pole Opis Wartości typu enum
enabled Boolean! Określa, czy automatyczne wypełnianie pytania jest włączone. Jeśli wartość to true, wartości zostaną automatycznie pobrane ze wskazanego źródła.
lookup String! Nazwa pola lub parametru do wyszukania w źródle danych do wstępnego wypełniania. W przypadku źródeł Account jest to właściwość użytkownika, np. imię i nazwisko lub adres e-mail. W przypadku źródeł QueryParam jest to nazwa parametru ustawionego w adresie URL.
source FormQuestionPrefillSources Źródła danych do wstępnego wypełniania wartości pytań. Account
QueryParam

FormQuestionType

Obsługiwane wartości typu enum FormQuestionType.

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

Następujące wartości są dostępne w wersji API 2026-07 i nowszych:

HOUR DISPLAY_TEXT PAGE_BLOCK

FormTag

Tablica tagów śledzących służących do kategoryzacji i analityki.

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"
  }
}

❗️ Zmiana powodująca niezgodność wsteczną w wersji 2026-10

Pole value w typie FormTag zostało usunięte w wersji API 2026-10. Przed przejściem na wersję 2026-10 usuń ze wszystkich zapytań dotyczących tagów formularza żądania pola value.

Pole Opis
columnId String! Unikatowy identyfikator kolumny powiązanej z tagiem.
id String! Unikatowy identyfikator tagu.
name String! Nazwa tagu.

ResponseForm

Obiekt zawierający informacje o dostępności, wyglądzie, funkcjach, pytaniach i tagach formularza.

Pole Opis Obsługiwane pola podrzędne
accessibility FormAccessibility Ustawienia dostępności formularza. language String
logoAltText String
active Boolean! Określa, czy formularz jest widoczny i przyjmuje odpowiedzi.
appearance FormAppearance Ustawienia stylu wizualnego formularza. background FormBackground
hideBranding Boolean!
layout FormLayout
logo FormLogo
primaryColor String
showProgressBar Boolean!
submitButton FormSubmitButton
text FormText
createWithAi Boolean! Określa, czy formularz został pierwotnie utworzony za pomocą kreatora formularzy monday.com wspieranego przez AI.
description String Opcjonalny opis formularza wyświetlany pod tytułem.
features FormFeatures Ustawienia przełączników i funkcji formularza. afterSubmissionView FormAfterSubmissionView
closeDate FormCloseDate
draftSubmission FormDraftSubmission
isInternal Boolean!
monday FormMonday
password FormPassword
preSubmissionView FormPreSubmissionView
reCaptchaChallenge Boolean!
requireLogin FormRequireLogin
responseLimit FormResponseLimit
shortenedLink FormShortenedLink
id Int! Unikatowy identyfikator widoku formularza na tablicy.
isAnonymous Boolean! Określa, czy odpowiedzi są zbierane anonimowo.
ownerId Int Identyfikator użytkownika będącego właścicielem lub twórcą formularza.
questions [FormQuestion!] Tablica obiektów pytań tworzących formularz, uporządkowanych według kolejności wyświetlania. description String
id String!
options [FormQuestionOption!]
required Boolean!
settings FormQuestionSettings
show_if_rules JSON
title String!
type FormQuestionType
visible Boolean!
tags [FormTag!] Tagi śledzące służące do kategoryzacji i analityki. columnId String!
id String!
name String!
value String
title String! Tytuł wyświetlany u góry formularza.
token String! Unikatowy token formularza w postaci ciągu znaków. Używany w zapytaniach i mutacjach API.
type String Typ formularza.

SetFormPasswordInput

Obiekt definiujący hasło do formularza.

Pole Typ Opis
password String! Hasło do formularza.

UpdateFormInput

Obiekt definiujący właściwości formularza do zaktualizowania.

Pole Opis Obsługiwane pola
description String Zaktualizowany opis formularza.
questions [QuestionOrderInput!] Uporządkowana tablica wszystkich identyfikatorów pytań w formularzu. Musi zawierać identyfikator każdego istniejącego pytania. Ich kolejność określa kolejność wyświetlania pytań. id String! page_block_id String (wersja 2026-07 i nowsze)
title String Zaktualizowany tytuł formularza. Musi zawierać co najmniej jeden znak.

UpdateFormSettingsInput

Obiekt definiujący ustawienia formularza do zaktualizowania.

Pole Opis Obsługiwane pola
accessibility FormAccessibilityInput Zaktualizowane ustawienia dostępności formularza. language String
logoAltText String
appearance FormAppearanceInput Zaktualizowane ustawienia stylu wizualnego formularza. background FormBackgroundInput
hideBranding Boolean
layout FormLayoutInput
logo FormLogoInput
primaryColor String
showProgressBar Boolean
submitButton FormSubmitButtonInput
text FormTextInput
is_anonymous Boolean (wersja 2026-07 i nowsze)
features FormFeaturesInput Zaktualizowane ustawienia przełączników i funkcji formularza. afterSubmissionView FormAfterSubmissionViewInput
closeDate FormCloseDateInput
draftSubmission FormDraftSubmissionInput
monday FormMondayInput
password FormPasswordInput
preSubmissionView FormPreSubmissionViewInput
reCaptchaChallenge Boolean
requireLogin FormRequireLoginInput
responseLimit FormResponseLimitInput
ai_translate Boolean (wersja 2026-07 i nowsze)

FormAccessibilityInput

Obiekt zawierający zaktualizowane dane wejściowe dla ustawień dostępności formularza.

Pole Opis
language String Kod języka określający lokalizację formularza i tekst interfejsu (np. „es”, „en”, „fr”).
logoAltText String Tekst alternatywny opisujący logo formularza.

FormAppearanceInput

Obiekt zawierający zaktualizowane dane wejściowe określające ogólny wygląd formularza (np. tło, układ, kolory i typografię).

Pole Opis Obsługiwane pola
background FormBackgroundInput Obiekt zawierający zaktualizowane dane wejściowe konfiguracji tła formularza. type FormBackgrounds!
value String
hideBranding Boolean Określa, czy branding monday.com jest ukryty.
layout FormLayoutInput Obiekt zawierający zaktualizowane dane wejściowe dotyczące struktury i prezentacji formularza. alignment FormAlignment
direction FormDirection
format FormFormat
logo FormLogoInput Obiekt zawierający zaktualizowane dane wejściowe konfiguracji wyświetlania logo formularza. position FormLogoPosition
size FormLogoSize
url String
primaryColor String Kod koloru HEX głównego koloru motywu używanego w formularzu.
showProgressBar Boolean Określa, czy wyświetlany jest wskaźnik postępu wypełniania formularza.
submitButton FormSubmitButtonInput Obiekt zawierający zaktualizowane dane wejściowe konfiguracji przycisku wysyłania formularza. text String
text FormTextInput Obiekt zawierający zaktualizowane dane wejściowe konfiguracji typografii i stylów tekstu formularza. color String
font String
size FormFontSize

FormBackgroundInput

Konfiguruje zaktualizowane tło formularza (np. kolor, obraz lub jego brak).

Pole Opis Wartości typu enum
type FormBackgrounds! Typ tła formularza. Color
Image
None
value String

Wartość tła formularza.

  • Dla Color jest to kod koloru HEX.
  • Dla Image jest to adres URL obrazu.

FormLayoutInput

Definiuje zaktualizowane dane wejściowe układu, wyrównania i formatu formularza.

❗️ Zmiana powodująca niezgodność wsteczną w wersji 2026-10

Pole format zostało usunięte w wersji API 2026-10. Przed przejściem na wersję 2026-10 usuń pole format z danych wejściowych FormLayoutInput.

Pole Opis Wartości typu enum
alignment FormAlignment Wyrównanie tekstu i zawartości formularza. Center
FullLeft
FullRight
Left
Right
direction FormDirection Kierunek czytania formularza. LtR
Rtl

FormLogoInput

Konfiguruje zaktualizowane dane wejściowe logo formularza (np. jego położenie, rozmiar i adres URL obrazu).

Pole Opis Wartości typu enum
position FormLogoPosition Położenie logo formularza. Auto
Center
Left
Right
size FormLogoSize Rozmiar logo formularza. ExtraLarge (wysokość 96px)
Large (wysokość 72px)
Medium (wysokość 40px)
Small (wysokość 32px)

FormSubmitButtonInput

Definiuje zaktualizowany tekst przycisku wysyłania formularza.

Pole Opis
text String Niestandardowy tekst wyświetlany na przycisku wysyłania formularza.

FormTextInput

Definiuje zaktualizowane dane wejściowe konfiguracji typografii formularza.

Pole Opis Wartości typu enum
color String Kod koloru HEX tekstu formularza.
font String Krój pisma używany w formularzu.
size FormFontSize Podstawowy rozmiar tekstu formularza. Large
Medium
Small

FormFeaturesInput

Obiekt zawierający dane wejściowe dla funkcji dostępnych na poziomie formularza, takich jak wymóg logowania, limity odpowiedzi i ochrona hasłem.

Pole Opis Obsługiwane pola
afterSubmissionView FormAfterSubmissionViewInput Obiekt zawierający zaktualizowane dane wejściowe konfiguracji formularza po jego wysłaniu. allowEditSubmission Boolean
allowResubmit Boolean
allowViewSubmission Boolean
description String
redirectAfterSubmission FormRedirectAfterSubmissionInput
showSuccessImage Boolean
title String
closeDate FormCloseDateInput Obiekt zawierający zaktualizowane dane wejściowe konfiguracji automatycznego zamknięcia formularza. date String
enabled Boolean
draftSubmission FormDraftSubmissionInput Obiekt zawierający zaktualizowane dane wejściowe konfiguracji zapisywania wersji roboczych formularza. enabled Boolean
monday FormMondayInput Obiekt zawierający zaktualizowane dane wejściowe ustawień tablicy dotyczących obsługi odpowiedzi. includeNameQuestion Boolean
includeUpdateQuestion Boolean
itemGroupId String
syncQuestionAndColumnsTitles Boolean
password FormPasswordInput Obiekt zawierający zaktualizowane dane wejściowe konfiguracji ochrony formularza hasłem. enabled Boolean
preSubmissionView FormPreSubmissionViewInput Obiekt zawierający zaktualizowane dane wejściowe konfiguracji ekranu powitalnego. description String
enabled Boolean
startButton FormStartButtonInput
title String
reCaptchaChallenge Boolean Określa, czy w formularzu włączono weryfikację reCAPTCHA, aby zapobiec wysyłaniu spamu.
requireLogin FormRequireLoginInput Obiekt zawierający zaktualizowane dane wejściowe ustawień wymogu logowania do formularza. enabled Boolean
redirectToLogin Boolean
responseLimit FormResponseLimitInput Obiekt zawierający zaktualizowane dane wejściowe ustawień limitu odpowiedzi. enabled Boolean
limit Int

FormAfterSubmissionViewInput

Obiekt zawierający zaktualizowane ustawienia formularza po jego wysłaniu.

Pole Opis Obsługiwane pola
allowEditSubmission Boolean Określa, czy użytkownicy mogą edytować swoje odpowiedzi po wysłaniu formularza.
allowResubmit Boolean Określa, czy użytkownicy mogą wielokrotnie wysyłać odpowiedzi w tym samym formularzu.
allowViewSubmission Boolean Określa, czy użytkownicy mogą wyświetlić swoje odpowiedzi po wysłaniu formularza.
description String Tekst wyświetlany po wysłaniu formularza.
redirectAfterSubmission FormRedirectAfterSubmissionInput Obiekt zawierający konfigurację przekierowania po wysłaniu formularza. enabled Boolean
redirectUrl String
showSuccessImage Boolean Określa, czy po wysłaniu formularza wyświetlany jest obraz potwierdzający powodzenie.
title String Tytuł wyświetlany po wysłaniu formularza.

FormRedirectAfterSubmissionInput

Obiekt zawierający zaktualizowane dane wejściowe konfiguracji przekierowania po wysłaniu formularza.

Pole Opis
enabled Boolean Określa, czy po wypełnieniu formularza respondenci są automatycznie przekierowywani pod wskazany adres URL.
redirectUrl String Adres URL, pod który użytkownicy są przekierowywani po pomyślnym wypełnieniu formularza.

FormCloseDateInput

Obiekt zawierający zaktualizowane dane wejściowe konfiguracji automatycznego zamknięcia formularza.

Pole Opis
date String Znacznik czasu ISO 8601 określający, kiedy formularz automatycznie przestanie przyjmować odpowiedzi.
enabled Boolean Określa, czy formularz jest automatycznie zamykany w określonym dniu i o określonej godzinie.

FormDraftSubmissionInput

Obiekt zawierający zaktualizowane dane wejściowe konfiguracji zapisywania wersji roboczych formularza.

Pole Opis
enabled Boolean Określa, czy użytkownicy mogą zapisywać nieukończone odpowiedzi jako wersje robocze.

FormMondayInput

Obiekt zawierający zaktualizowane dane wejściowe ustawień tablicy dotyczących obsługi odpowiedzi w formularzu.

Pole Opis
includeNameQuestion Boolean Określa, czy do formularza dodawane jest pytanie o imię i nazwisko. Odpowiada ono kolumnie nazwy elementu na tablicy.
includeUpdateQuestion Boolean Określa, czy do formularza dodawane jest pole aktualizacji. Odpowiada ono sekcji aktualizacji powiązanego elementu.
itemGroupId String Identyfikator grupy na tablicy, w której na podstawie odpowiedzi z formularza zostaną utworzone nowe elementy.
syncQuestionAndColumnsTitles Boolean Określa, czy tytuł pytania w formularzu jest synchronizowany z nazwą kolumny na tablicy.
allow_create_item Boolean Określa, czy wysłanie formularza powoduje utworzenie nowego elementu na połączonej tablicy. Dostępne tylko w wersji 2026-07 i nowszych.

FormPasswordInput

Obiekt zawierający zaktualizowane dane wejściowe konfiguracji ochrony formularza hasłem.

Pole Opis
enabled Boolean Określa, czy użytkownicy muszą podać hasło, aby uzyskać dostęp do formularza. To ustawienie można wykorzystać tylko do wyłączenia ochrony hasłem. Aby ją włączyć, użyj mutacji set_form_password.

FormPreSubmissionViewInput

Obiekt zawierający zaktualizowane dane wejściowe dla ustawień opcjonalnego ekranu powitalnego wyświetlanego przed rozpoczęciem formularza.

Pole Opis Obsługiwane pola
description String Tekst wyświetlany na ekranie powitalnym.
enabled Boolean Określa, czy przed rozpoczęciem formularza wyświetlany jest ekran powitalny.
startButton FormStartButtonInput Obiekt zawierający zaktualizowane dane wejściowe konfiguracji przycisku rozpoczęcia na ekranie powitalnym formularza. text String
title String Tytuł wyświetlany na ekranie powitalnym.

FormRequireLoginInput

Obiekt zawierający zaktualizowane dane wejściowe ustawień wymogu logowania do formularza.

Pole Opis
enabled Boolean Określa, czy użytkownicy muszą się zalogować przed wysłaniem odpowiedzi.
redirectToLogin Boolean Określa, czy nieuwierzytelnieni użytkownicy są automatycznie przekierowywani na stronę logowania.

FormResponseLimitInput

Obiekt zawierający zaktualizowane dane wejściowe ustawień limitu odpowiedzi.

Pole Opis
enabled Boolean Określa, czy limity odpowiedzi w formularzu są włączone.
limit Int Maksymalna liczba odpowiedzi, które można przesłać w formularzu.

UpdateFormTagInput

❗️ Usunięty w wersji 2026-10

Typ UpdateFormTagInput i mutacja update_form_tag zostały usunięte w wersji API 2026-10. Przed przejściem na tę wersję usuń wszystkie ich użycia.

Obiekt zawierający zaktualizowane tagi pytania (usunięte w wersji 2026-10).

Pole Typ Opis
value String Zaktualizowana wartość tagu.

UpdateQuestionInput

Obiekt zawierający zaktualizowane właściwości pytania.

Pole Opis Obsługiwane pola
description String Zaktualizowany opis pytania.
required Boolean Określa, czy odpowiedź na pytanie jest wymagana do wysłania formularza.
settings FormQuestionSettingsInput Zaktualizowane ustawienia właściwe dla typu pytania. checkedByDefault Boolean
defaultCurrentDate Boolean
display FormQuestionSelectDisplay
includeTime Boolean
locationAutofilled Boolean
optionsOrder FormQuestionSelectOrderByOptions
prefill PrefillSettingsInput
prefixAutofilled Boolean
prefixPredefined PhonePrefixPredefinedInput
skipValidation Boolean
title String Zaktualizowany tytuł pytania.
type FormQuestionType! Zaktualizowany typ pytania, który określa sposób wprowadzania danych i ich walidację. Nie można przekazać nowego typu pytania - musi on być zgodny z typem istniejącego pytania.
visible Boolean Określa, czy pytanie jest widoczne dla respondentów. Ukryte pytania pozostają w strukturze formularza, ale nie są wyświetlane respondentom.
show_if_rules JSON Zaktualizowane reguły logiki warunkowej dla tego pytania. Dostępne tylko w wersji 2026-07 i nowszych.
options [QuestionOptionInput!] Zaktualizowane opcje w pytaniach wyboru. Dostępne tylko w wersji 2026-07 i nowszych.

FormQuestionSettingsInput

Obiekt zawierający zaktualizowaną konfigurację właściwą dla typu pytania. Jeśli podasz ustawienie właściwe dla konkretnego typu (np. includeTime), formularz musi zawierać pytanie tego typu. W przeciwnym razie mutacja nie zadziała.

Pole Opis Wartości typu enum Obsługiwane pola
checkedByDefault Boolean Określa, czy pole wyboru ma być domyślnie zaznaczone. Dotyczy tylko pytań typu Boolean i Checkbox.
defaultCurrentDate Boolean Określa, czy bieżąca data jest ustawiana jako wartość domyślna. Dotyczy tylko pytań dotyczących daty.
display FormQuestionSelectDisplay Opcje wyświetlania pytań typu select. Dotyczy tylko pytań jednokrotnego lub wielokrotnego wyboru. Dropdown
Horizontal
Vertical
includeTime Boolean Określa, czy selektor daty zawiera wybór godziny i minut. Jeśli wartość to false, uwzględniana jest tylko data. Dotyczy tylko pytań dotyczących daty.
locationAutofilled Boolean Określa, czy lokalizacja respondenta jest automatycznie wykrywana i wstawiana. Wykorzystywane są do tego usługi geolokalizacyjne przeglądarki. Wymagana jest zgoda użytkownika. Dotyczy tylko pytań dotyczących lokalizacji.
optionsOrder FormQuestionSelectOrderByOptions Opcje sortowania odpowiedzi w pytaniach typu select. Dotyczy tylko pytań jednokrotnego lub wielokrotnego wyboru. Alphabetical
Custom
Random
prefill PrefillSettingsInput Konfiguracja automatycznego wypełniania wartości pytań. enabled Boolean!
lookup String
source FormQuestionPrefillSources
prefixAutofilled Boolean Określa, czy prefiks kraju numeru telefonu jest automatycznie wykrywany i wstawiany. Wykorzystywana jest do tego lokalizacja respondenta lub ustawienia przeglądarki. Dotyczy tylko pytań dotyczących numeru telefonu.
prefixPredefined PhonePrefixPredefinedInput Konfiguracja wstępnie zdefiniowanego prefiksu kraju dla numeru telefonu, który zostanie wstępnie wybrany dla respondentów. Dotyczy tylko pytań dotyczących numeru telefonu. enabled Boolean!
prefix String
skipValidation Boolean Określa, czy walidacja formatu adresu URL jest pomijana, co pozwala wprowadzić dowolny tekst. Dotyczy tylko pytań dotyczących linku lub adresu URL.
label_limit_count_enabled Boolean Określa, czy przy pytaniach tekstowych wyświetlany jest limit liczby znaków. Dostępne tylko w wersji 2026-07 i nowszych.
default_answer String Domyślna odpowiedź wstawiana po wyświetleniu pytania. Dostępne tylko w wersji 2026-07 i nowszych.

PhonePrefixPredefinedInput

Definiuje konfigurację wstępnego wyboru prefiksu kraju dla numeru telefonu respondenta.

Pole Opis
enabled Boolean! Określa, czy dla pytań o numer telefonu włączono wstępnie zdefiniowany prefiks kraju. Jeśli wartość to true, wskazany prefiks zostanie wstępnie wybrany.
prefix String Wstępnie zdefiniowany prefiks kraju zapisany wielkimi literami (np. „US”, „UK”).

PrefillSettingsInput

Definiuje konfigurację automatycznego wypełniania wartości pytań.

Pole Opis Wartości typu enum
enabled Boolean! Określa, czy automatyczne wypełnianie pytania jest włączone. Jeśli wartość to true, wartości zostaną automatycznie pobrane ze wskazanego źródła.
lookup String Nazwa pola lub parametru do wyszukania w źródle danych do wstępnego wypełniania. W przypadku źródeł Account jest to właściwość użytkownika, np. imię i nazwisko lub adres e-mail. W przypadku źródeł QueryParam jest to nazwa parametru ustawionego w adresie URL.
source FormQuestionPrefillSources Źródła danych do wstępnego wypełniania wartości pytań. Account
QueryParam