--- updatedAt: 2026-01-28T13:05:19.000Z --- Fetch the complete documentation index at: https://developer.connecteam.com/llms.txt. Use this file to discover all available pages before exploring further. # Form submission webhook The Form Submission webhook notifies you when forms are submitted or updated in Connecteam. ## Events | Event Type | Description | | :----------------------- | :----------------------------------------------- | | form\_submission | A new form was submitted | | form\_submission\_edited | An existing form submission was edited | | manager\_field\_updated | Manager-only fields were updated on a submission | *** ## Payload Structure All form webhook events share a common structure with the form data nested in the `data` field. ### Common Fields | Field | Type | Description | | :------------- | :------ | :-------------------------- | | requestId | string | Unique request identifier | | company | string | Company identifier | | activityType | string | Always `forms` | | eventType | string | The event type | | eventTimestamp | integer | Unix timestamp of the event | | data | object | Form submission data | ### Form Submission Data Fields | Field | Type | Description | | :----------------------- | :------ | :---------------------------------------------------------------------------- | | formSubmissionId | string | Unique submission identifier | | formId | integer | Form template ID | | submissionTimestamp | integer | Unix timestamp of submission | | submissionTimezone | string | Timezone of submission | | submissionStartTimestamp | integer | When user opened the form | | entryNum | integer | Submission number | | submittingUserId | integer | ID of the submitting user | | isAnonymous | boolean | Whether submission is anonymous | | answers | array | Array of question answers | | managerFields | array | Manager-only fields (in `form_submission_edited` and `manager_field_updated`) | *** ## Event Examples ### form\_submission Triggered when a user submits a form. ```json { "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "company": "your_company_id", "activityType": "forms", "eventType": "form_submission", "eventTimestamp": 1736760013, "data": { "formSubmissionId": "5b43a76b1d41c85da1ff8b77", "formId": 12345, "submissionTimestamp": 1736760013, "submissionTimezone": "America/New_York", "submissionStartTimestamp": 1736759900, "entryNum": 15, "submittingUserId": 9063791, "isAnonymous": false, "answers": [ { "questionId": "6d4d5595-2e9e-3dd8-deda-6ace575fa6af", "questionType": "multipleChoice", "wasHidden": false, "submissionTimestamp": 1736760010, "wasSubmittedEmpty": false, "selectedAnswers": [ {"multipleChoiceOptionId": "opt1", "text": "Yes"} ] }, { "questionId": "7e5e6696-3f9f-4ee9-efeb-7bdf686gb7bg", "questionType": "openEnded", "wasHidden": false, "submissionTimestamp": 1736760011, "wasSubmittedEmpty": false, "value": "All equipment checked and operational" }, { "questionId": "8f6f7797-4g0g-5ff0-fgfc-8ceg797hc8ch", "questionType": "signature", "wasHidden": false, "submissionTimestamp": 1736760012, "wasSubmittedEmpty": false, "images": [ {"url": "https://storage.example.com/signatures/abc123.png"} ] } ] } } ``` ### form\_submission\_edited Triggered when a user edits their submitted form. ```json { "requestId": "b2c3d4e5-f6g7-8901-bcde-fg2345678901", "company": "your_company_id", "activityType": "forms", "eventType": "form_submission_edited", "eventTimestamp": 1736763600, "data": { "formSubmissionId": "5b43a76b1d41c85da1ff8b77", "formId": 12345, "submissionTimestamp": 1736760013, "submissionTimezone": "America/New_York", "submissionStartTimestamp": 1736759900, "entryNum": 15, "submittingUserId": 9063791, "isAnonymous": false, "answers": [ { "questionId": "7e5e6696-3f9f-4ee9-efeb-7bdf686gb7bg", "questionType": "openEnded", "value": "Updated: Fire extinguisher needs replacement" } ], "managerFields": [ { "managerFieldId": "mgr-field-1", "managerFieldType": "note", "note": "Reviewed and approved" } ] } } ``` ### manager\_field\_updated Triggered when an admin updates manager-only fields on a submission. ```json { "requestId": "c3d4e5f6-g7h8-9012-cdef-gh3456789012", "company": "your_company_id", "activityType": "forms", "eventType": "manager_field_updated", "eventTimestamp": 1736767200, "data": { "formSubmissionId": "5b43a76b1d41c85da1ff8b77", "formId": 12345, "submissionTimestamp": 1736760013, "submissionTimezone": "America/New_York", "entryNum": 15, "managerFields": [ { "managerFieldId": "status-field-1", "managerFieldType": "status", "lastUpdatedTimestamp": 1736767200, "status": { "statusOptionId": "approved", "name": "Approved", "color": "#4CAF50" } }, { "managerFieldId": "owner-field-1", "managerFieldType": "owner", "userId": 9063792 } ] } } ``` *** ## Question Types Form submissions can include the following question types: | Question Type | Value Fields | Description | | :--------------- | :------------------------------------------------------------ | :--------------------------- | | `multipleChoice` | `selectedAnswers[]` with `multipleChoiceOptionId`, `text` | Multiple choice selection | | `yesNo` | `selectedIndex` (integer) | Yes/No binary choice | | `openEnded` | `value` (string) | Free text input | | `number` | `inputValue` (float) | Numeric input | | `emailAddress` | `value` (string) | Email address input | | `phoneNumber` | `value` (string with country code) | Phone number input | | `datetime` | `timestamp`, `timezone`, `isDateSubmitted`, `isTimeSubmitted` | Date and/or time picker | | `rating` | `ratingValue` (integer) | Star rating | | `slider` | `value` (integer) | Slider value | | `signature` | `images[]` with `url` | Digital signature | | `image` | `images[]` with `url` | Photo upload | | `scanDocument` | `images[]` with `url` | Document scanner | | `video` | `videos[]` with `videoUrl` | Video upload | | `audioRecording` | `audioUrl`, `audioLength` | Audio recording | | `files` | `files[]` with `url`, `size`, `fileName` | File attachments | | `location` | `locationInput` with `address`, `latitude`, `longitude` | GPS location | | `imageSelection` | `selectedAnswers[]` with `imageSelectionId`, `text`, `image` | Image-based choice | | `task` | `isChecked` (boolean) | Checkbox task | | `formula` | `result` (float), `status` | Calculated formula result | | `description` | (no value) | Display-only text block | | `group` | `answers[]` | Grouped questions | | `multiGroup` | `groupAnswers[]` | Repeatable grouped questions | *** ## Manager Field Types | Manager Field Type | Value Fields | Description | | :----------------- | :----------------------------------------------------------------------------- | :---------------- | | `status` | `status` object with `statusOptionId`, `name`, `color`; `lastUpdatedTimestamp` | Status dropdown | | `owner` | `userId` (integer) | Assigned owner | | `signature` | `image` (base64), `signingUserId`, `signingTimestamp` | Manager signature | | `file` | `files[]` with `filename`, `fileUrl` | File attachment | | `date` | `date` (string) | Date field | | `note` | `note` (string) | Text note | *** ## Common Answer Fields All answer objects include these metadata fields: | Field | Type | Description | | :------------------ | :------ | :---------------------------------------- | | questionId | string | Question identifier | | questionType | string | Type of question (see above) | | wasHidden | boolean | Whether question was hidden by conditions | | submissionTimestamp | integer | When answer was submitted | | wasSubmittedEmpty | boolean | Whether answer was left empty | | location | object | GPS coordinates if location required | | updateTimestamp | integer | Last update timestamp | | updateUserId | integer | User who last updated | *** [API Reference](https://developer.connecteam.com/reference/)