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.

{
  "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.

{
  "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.

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