Dokumentacja dla programistów

Utwórz zgłoszenie w formularzu (Platform MCP)

Aktualizacja 2026-09-06

Użyj tego narzędzia, aby przesłać odpowiedź do monday.com WorkForm. Każde zgłoszenie tworzy nowy element na tablicy powiązanej z formularzem i wypełnia wartości kolumn na podstawie podanych odpowiedzi. Możesz przesłać odpowiedź, używając samego tokenu formularza, pełnego adresu WorkForm (https://forms.monday.com/forms/{token}?r=use1) albo skróconego adresu wkf.ms - skrócone adresy są rozpoznawane automatycznie.

Przed wysłaniem zawsze wywołaj get_form. Potrzebujesz dokładnych identyfikatorów pytań, aby prawidłowo przypisać do nich odpowiedzi. W przypadku pytań SingleSelect i MultiSelect potrzebujesz też identyfikatorów opcji zwróconych przez get_form - widoczne etykiety nie są prawidłowymi wartościami odpowiedzi. Sprawdź również showIfRules każdego pytania, aby ustalić, które pytania są wyświetlane warunkowo na podstawie wcześniejszych odpowiedzi. Wysyłaj odpowiedzi tylko na pytania, które są widoczne.

Zbierz wszystkie odpowiedzi przed wywołaniem tego narzędzia. Nie wywołuj go osobno dla każdego pytania - najpierw zbierz wszystkie odpowiedzi, a potem prześlij je w jednym wywołaniu jako tablicę.

Typowy przebieg pracy z formularzem: 1. create_form - Utwórz formularz i pobierz formToken 2. form_questions_editor - Dodaj, zaktualizuj lub usuń pytania 3. update_form - Skonfiguruj tytuł, wygląd i funkcje formularza 4. get_form - Pobierz identyfikatory i typy pytań, opcje oraz reguły warunkowe 5. create_form_submission ← Jesteś tutaj - Prześlij odpowiedzi i odbierz submission_id

Parametry

Parametr	Typ	Wymagane	Opis
form_token	`string`	Tak	Token formularza, pełny adres WorkForm lub skrócony adres `wkf.ms`. Skrócone adresy są rozpoznawane automatycznie.
answers	`array`	Tak	Tablica obiektów odpowiedzi. Każdy obiekt musi zawierać `question_id` i dokładnie jedno pole odpowiedzi zgodne z typem pytania. Zobacz niżej opis pól odpowiedzi.
form_timezone_offset	`number`	Tak	Różnica między strefą czasową osoby wysyłającej a UTC, podana w minutach (np. `-120` dla UTC−2, `0` dla UTC, `120` dla UTC+2).
password	`string`	Warunkowo	Wymagane tylko wtedy, gdy formularz jest chroniony hasłem (sprawdź `features.password.enabled` w wyniku `get_form`).
tags	`array`	Nie	Etykiety routingu, które zostaną przypisane do zgłoszenia. Każda etykieta mapuje `column_id` na `value`.

Opis pól odpowiedzi (ustaw dokładnie jedno pole w każdym obiekcie odpowiedzi):

Pole	Typ	Używane w pytaniach
`name`	`string`	typu `Name`
`email`	`string`	typu `Email`
`short_text`	`string`	typu `ShortText`
`long_text`	`string`	typu `LongText`
`link`	`string`	typu `Link`
`updates`	`string`	typu `Updates`
`boolean`	`boolean`	typu `Boolean`
`number`	`number`	typu `Number`
`rating`	`number`	typu `Rating` - musi mieć wartość ≥ 1 i mieścić się w skonfigurowanym limicie pytania
`single_select`	`string`	typu `SingleSelect` - identyfikator wybranej opcji, nie jej etykieta
`multi_select`	`array`	typu `MultiSelect` - lista identyfikatorów wybranych opcji
`people`	`array`	typu `People` - lista identyfikatorów użytkowników (użyj `list_users_and_teams`)
`connected_boards`	`array`	typu `ConnectedBoards` - lista identyfikatorów połączonych elementów
`phone`	`object`	typu `Phone` - `{ phone, country_short_name }`
`country`	`object`	typu `Country` - `{ country_name, country_code }`
`date`	`object`	typu `Date` - `{ date: "YYYY-MM-DD", zone_diff? }`
`date_range`	`object`	typu `DateRange` - `{ from: "YYYY-MM-DD", to: "YYYY-MM-DD" }`
`location`	`object`	typu `Location` - pełny, uporządkowany adres zawierający `lat`, `lng`, `place_id` i składowe adresu
`file`	`array`	typu `File` - najpierw prześlij pliki, aby uzyskać identyfikator pliku
`signature`	`object`	typu `Signature` - najpierw prześlij plik

Przykład

Prześlij odpowiedź do formularza testowego, podając imię i nazwisko oraz krótką odpowiedź tekstową:

{
  "form_token": "your_form_token_here",
  "form_timezone_offset": 0,
  "answers": [
    {
      "question_id": "name",
      "name": "API Tester"
    },
    {
      "question_id": "short_text413vvqbb",
      "short_text": "Automations and integrations"
    }
  ]
}

Narzędzie zwróciło submission_id: "4b4cb753-b3bd-4184-a7b6-7c9b949d3754", potwierdzając zapisanie zgłoszenia. Na tablicy powiązanej z formularzem pojawił się nowy element z podanymi wartościami.

Odpowiednik programistyczny

Formularzami monday.com WorkForms zarządza się w interfejsie monday.com lub za pośrednictwem MCP. Ta operacja nie ma bezpośredniego odpowiednika w GraphQL.

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