Dokumentacja dla programistów

Formularz

Dokumentacja API (rdzeń)Dokumentacja API

Aktualizacja 2026-09-06

monday.com Workforms umożliwia tworzenie i udostępnianie niestandardowych formularzy, które automatycznie synchronizują się z tablicami i przepływami pracy monday.com. Możesz w pełni kontrolować ustawienia formularza, w tym pytania, wygląd i ustawienia dostępności.

Zapytania

Pobieranie formularza

Aby wykonać to zapytanie, musisz mieć dostęp do tablicy powiązanej z formularzem.
Zwraca metadane wybranego formularza.
Można je wykonać tylko na poziomie głównym. Nie można zagnieżdżać go w innym zapytaniu.

query {
  form(formToken: "YOUR_FORM_TOKEN") {
    id
    title
    active
    appearance {
      primaryColor
      showProgressBar
    }
    features {
      responseLimit {
        enabled
        limit
      }
    }
    questions {
      id
      title
      type
      required
      visible
    }
  }
}

{
  "data": {
    "form": {
      "id": 12345,
      "title": "Customer Feedback Survey",
      "active": true,
      "appearance": {
        "primaryColor": "#2196f3",
        "showProgressBar": false
      },
      "features": {
        "responseLimit": {
          "enabled": true,
          "limit": 500
        }
      },
      "questions": [
        { "id": "q1", "title": "What is your full name?", "type": "Name", "required": true, "visible": true },
        { "id": "q2", "title": "What is your email address?", "type": "Email", "required": true, "visible": true },
        { "id": "q3", "title": "How would you rate your experience?", "type": "Rating", "required": false, "visible": true }
      ]
    }
  }
}

Argumenty

Argument	Typ	Opis
formToken	`String!`	Unikalny token tekstowy formularza, widoczny w jego adresie URL.

Jak uzyskać token formularza

Pełny adres URL

Otwórz formularz i kliknij Udostępnij formularz (Share form) w prawym górnym rogu.
Otworzy się wyskakujące okno z adresem URL formularza, który możesz udostępnić.

Przykładowy adres URL: https://forms.monday.com/forms/abc123def456ghi789?r=use1

Token to ciąg znaków alfanumerycznych, który znajduje się po /forms/ i przed ?. W powyższym przykładzie tokenem jest abc123def456ghi789.

Pełny adres URL formularza do udostępnienia

Skrócony adres URL

Otwórz formularz i kliknij Udostępnij formularz (Share form) w prawym górnym rogu.
Otworzy się wyskakujące okno ze skróconym adresem URL formularza.

Kliknij Kopiuj link (Copy link) i wklej link na nowej karcie.
Po otwarciu formularza zobaczysz jego pełny adres URL do udostępnienia.
Token to ciąg znaków alfanumerycznych, który znajduje się po /forms/ i przed ?.

Pola

Pole	Typ	Opis
accessibility	`FormAccessibility`	Ustawienia dostępności formularza.
active	`Boolean!`	Określa, czy formularz jest widoczny i przyjmuje odpowiedzi.
appearance	`FormAppearance`	Ustawienia wyglądu formularza.
builtWithAi	`Boolean!`	Określa, czy formularz utworzono za pomocą kreatora formularzy monday.com wspieranego przez AI.
description	`String`	Opcjonalny opis formularza, wyświetlany pod tytułem.
features	`FormFeatures`	Przełączniki i ustawienia funkcji formularza.
id	`Int!`	Unikalny identyfikator widoku tablicy formularza.
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, w kolejności ich wyświetlania.
tags	`[FormTag!]`	Tagi do śledzenia, kategoryzowania i analizowania danych.
title	`String!`	Tytuł wyświetlany u góry formularza.
token	`String!`	Unikalny token tekstowy formularza. Używany w zapytaniach i mutacjach API.
type	`String`	Typ formularza.

Mutacje

Aby wykonać te mutacje, musisz mieć uprawnienia do edycji formularza.

❗️ Zmiana niezgodna wstecz w wersji 2026-10

Mutacja update_form_tag została usunięta w wersji API 2026-10. Jeśli Twoja integracja korzysta z update_form_tag, usuń tę mutację przed migracją do wersji 2026-10. Po utworzeniu tagów nie można już aktualizować - zamiast tego usuń tag i utwórz go ponownie.

Tworzenie formularza

Tworzy nowy formularz. Zwraca DehydratedFormResponse.

mutation {
  create_form(
    board_kind: public
    destination_folder_id: 1234567890
    destination_folder_name: "Customer Feedback 2025"
    destination_name: "Customer Feedback Q4"
    destination_workspace_id: 9876543210
  ) {
    boardId
        token
  }
}

{
  "data": {
    "create_form": {
      "boardId": "1234567890",
      "token": "YOUR_FORM_TOKEN"
    }
  },
  "extensions": {
    "request_id": "YOUR_REQUEST_ID"
  }
}

Argumenty

Argument	Typ	Opis	Wartości wyliczenia
board_kind	`BoardKind`	Typ tablicy.	`private` `public` `share`
board_owner_ids	`[Float!]`	Identyfikatory użytkowników, którzy będą właścicielami tablicy przechowującej odpowiedzi z formularza.
board_owner_team_ids	`[Float!]`	Identyfikatory zespołów, których członkowie będą właścicielami tablicy przechowującej odpowiedzi z formularza.
board_subscriber_ids	`[Float!]`	Identyfikatory użytkowników, którzy będą obserwować tablicę przechowującą odpowiedzi z formularza.
board_subscriber_teams_ids	`[Float!]`	Identyfikatory zespołów, których członkowie będą obserwować tablicę przechowującą odpowiedzi z formularza.
destination_folder_id	`Float`	Unikalny identyfikator folderu, w którym zostanie utworzony formularz.
destination_folder_name	`String`	Nazwa folderu, w którym zostanie utworzony formularz.
destination_name	`String`	Nazwa tablicy, która zostanie utworzona do przechowywania odpowiedzi z formularza.
destination_workspace_id	`Float!`	Unikalny identyfikator obszaru roboczego, w którym zostanie utworzony formularz.

Tworzenie pytania w formularzu

Tworzy nowe pytanie w formularzu. Zwraca FormQuestion.

mutation {
  create_form_question(
    formToken: "YOUR_FORM_TOKEN"
    question: {
      title: "Phone"
      description: "Enter your phone number."
      type: Phone
      required: true
      settings: {
        prefixAutofilled: false
        prefixPredefined: {
          enabled: true
          prefix: "+1"
        }
      }
    }
  ) {
    id
  }
}

{
  "data": {
    "create_form_question": {
      "id": "YOUR_QUESTION_ID"
    }
  },
  "extensions": {
    "request_id": "YOUR_REQUEST_ID"
  }
}

Argumenty

Argument	Typ	Opis
formToken	`String!`	Unikalny identyfikator formularza. Możesz go znaleźć w adresie URL formularza.
question	`CreationQuestionInput!`	Obiekt zawierający właściwości pytania.

Tworzenie tagu formularza

Tworzy nowy tag dla formularza. Zwraca FormTag.

mutation {
  create_form_tag(
    formToken: "YOUR_FORM_TOKEN"
    tag: {
      name: "New Tag"
      value: "This is the new tag."
    }
  ) {
    id
  }
}

{
  "data": {
    "create_form_tag": {
      "id": "YOUR_TAG_ID"
    }
  },
  "extensions": {
    "request_id": "YOUR_REQUEST_ID"
  }
}

Argumenty

Argument	Typ	Opis
formToken	`String!`	Unikalny identyfikator formularza. Możesz go znaleźć w adresie URL formularza.
tag	`CreateFormTagInput!`	Nazwa i wartość tagu. Nazwa musi być unikalna w obrębie formularza.

Aktywowanie formularza

Aktywuje istniejący formularz, dzięki czemu staje się widoczny dla użytkowników i może przyjmować nowe zgłoszenia. Zwraca wartość Boolean, która określa, czy aktywacja się powiodła.

mutation {
  activate_form(
    formToken: "YOUR_FORM_TOKEN"
  )
}

{
  "data": {
    "activate_form": true
  },
  "extensions": {
    "request_id": "YOUR_REQUEST_ID"
  }
}

Argumenty

Argument	Typ	Opis
formToken	`String!`	Unikalny identyfikator formularza. Możesz go znaleźć w adresie URL formularza.

Aktualizowanie formularza

Aktualizuje tytuł lub opis formularza albo kolejność pytań. Zwraca ResponseForm.

mutation {
  update_form(
    formToken: "YOUR_FORM_TOKEN"
    input: {
      description: "Your updated description."
      title: "Your updated title."
      questions: [
        { id: "Q1" }
        { id: "Q3" }
        { id: "Q2" }
      ]
    }
  ) {
    title
    description
    questions {
      type
    }
  }
}

{
  "data": {
    "update_form": {
      "title": "Your updated title.",
      "description": "Your updated description.",
      "questions": [
        {
          "type": "Name"
        },
        {
          "type": "ShortText"
        },
        {
          "type": "LongText"
        }
      ]
    }
  },
  "extensions": {
    "request_id": "YOUR_REQUEST_ID"
  }
}

Argumenty

Argument	Typ	Opis
formToken	`String!`	Unikalny identyfikator formularza. Możesz go znaleźć w adresie URL formularza.
input	`UpdateFormInput!`	Obiekt zawierający właściwości formularza do aktualizacji.

Aktualizowanie pytania w formularzu

Aktualizuje właściwości istniejącego pytania. Zwraca FormQuestion.

mutation {
  update_form_question(
    formToken: "YOUR_FORM_TOKEN"
    questionId: "Q1"
    question: {
      type: Name
      description: "Enter your name."
      settings: {
        prefill: {
          enabled: false
        }
      }
    }
  ) {
    description
    settings {
      prefill {
        enabled
      }
    }
  }
}

{
  "data": {
    "update_form_question": {
      "description": "Enter your name.",
      "settings": {
        "prefill": {
          "enabled": false
        }
      }
    }
  },
  "extensions": {
    "request_id": "YOUR_REQUEST_ID"
  }
}

Argumenty

Argument	Typ	Opis
formToken	`String!`	Unikalny identyfikator formularza. Możesz go znaleźć w adresie URL formularza.
question	`UpdateQuestionInput!`	Obiekt zawierający zaktualizowane właściwości pytania.
questionId	`String!`	Unikalny identyfikator pytania.

Aktualizowanie ustawień formularza

Aktualizuje funkcje formularza oraz ustawienia jego wyglądu i dostępności. Zwraca ResponseForm.

mutation {
  update_form_settings(
    formToken: "YOUR_FORM_TOKEN"
    settings: {
      appearance: {
        isAnonymous: true
      }
      accessibility: {
        language: "en"
      }
    }
  ) {
    isAnonymous
    accessibility {
      language
    }
  }
}

{
  "data": {
    "update_form_settings": {
      "isAnonymous": true,
      "accessibility": {
        "language": "en"
      }
    }
  },
  "extensions": {
    "request_id": "YOUR_REQUEST_ID"
  }
}

Argumenty

Argument	Typ	Opis
formToken	`String!`	Unikalny identyfikator formularza. Możesz go znaleźć w adresie URL formularza.
settings	`UpdateFormSettingsInput!`	Obiekt zawierający wszystkie ustawienia konfiguracji formularza.

Ustawianie hasła do formularza

Włącza ochronę hasłem i umożliwia ustawienie hasła. Zwraca ResponseForm.

mutation {
  set_form_password(
    formToken: "YOUR_FORM_TOKEN"
    input: {
      password: "NEW_PASSWORD"
    }
  ) {
    id
    title
  }
}

{
  "data": {
    "set_form_password": {
      "id": 123456789,
      "title": "Contact Information"
    }
  },
  "extensions": {
    "request_id": "YOUR_REQUEST_ID"
  }
}

Argumenty

Argument	Typ	Opis
formToken	`String!`	Unikalny identyfikator formularza. Możesz go znaleźć w adresie URL formularza.
input	`SetFormPasswordInput!`	Hasło do formularza. Musi składać się z co najmniej jednego znaku.

Skracanie adresu URL formularza

Skraca adres URL formularza i zapisuje go w jego ustawieniach. Zwraca FormShortenedLink, który zawiera obiekt skróconego linku.

mutation {
  shorten_form_url(
    formToken: "YOUR_FORM_TOKEN"
  ) {
    enabled
    url
  }
}

{
  "data": {
    "shorten_form_url": {
      "enabled": true,
      "url": "https://wkf.ms/0oOoOoO"
    }
  },
  "extensions": {
    "request_id": "YOUR_REQUEST_ID"
  }
}

Argumenty

Argument	Typ	Opis
formToken	`String!`	Unikalny identyfikator formularza. Możesz go znaleźć w adresie URL formularza.

Dezaktywowanie formularza

Dezaktywuje istniejący formularz, ukrywa go przed użytkownikami i blokuje przyjmowanie nowych zgłoszeń. Zwraca wartość Boolean, która określa, czy dezaktywacja się powiodła.

mutation {
  deactivate_form(
    formToken: "YOUR_FORM_TOKEN"
  )
}

{
  "data": {
    "deactivate_form": true
  },
  "extensions": {
    "request_id": "YOUR_REQUEST_ID"
  }
}

Argumenty

Argument	Typ	Opis
formToken	`String!`	Unikalny identyfikator formularza. Możesz go znaleźć w adresie URL formularza.

Usuwanie pytania

Trwale usuwa istniejące pytanie z formularza. Zwraca wartość Boolean, która określa, czy usunięcie się powiodło.

Uwaga: Usunięcie pytania jest nieodwracalne. Nie można go odzyskać po usunięciu.

mutation {
  delete_question(
    formToken: "YOUR_FORM_TOKEN"
    questionId: "YOUR_QUESTION_ID"
  )
}

{
  "data": {
    "delete_question": true
  },
  "extensions": {
    "request_id": "YOUR_REQUEST_ID"
  }
}

Argumenty

Argument	Typ	Opis
formToken	`String!`	Unikalny identyfikator formularza. Możesz go znaleźć w adresie URL formularza.
questionId	`String!`	Unikalny identyfikator pytania.

Usuwanie tagu formularza

Trwale usuwa tag z formularza. Zwraca wartość Boolean, która określa, czy usunięcie się powiodło.

mutation {
  delete_form_tag(
    formToken: "YOUR_FORM_TOKEN"
    tagId: "YOUR_TAG_ID"
    options: {
      deleteAssociatedColumn: true
    }
  )
}

{
  "data": {
    "delete_form_tag": true
  },
  "extensions": {
    "request_id": "YOUR_REQUEST_ID"
  }
}

Argumenty

Argument	Typ	Opis
formToken	`String!`	Unikalny identyfikator formularza. Możesz go znaleźć w adresie URL formularza.
options	`DeleteFormTagInput`	Opcje usuwania tagu.
tagId	`String!`	Unikalny identyfikator tagu.

Mam problem z tym tematem Źródło: developer.monday.com