Form Submissions

Read and update form submissions for a specific form.

Endpoints

Method	Endpoint	Description
GET	/forms/v1/forms/{formId}/form-submissions	List submissions
GET	/forms/v1/forms/{formId}/form-submissions/{formSubmissionId}	Single submission
PUT	/forms/v1/forms/{formId}/form-submissions/{formSubmissionId}	Update submission

Authentication

Operation	Scope
GET	`forms.read`
PUT	`forms.write`

GET — Query Parameters

Parameter	Type	Required	Default	Description
formId	integer (path)	Yes	—	Form to query.
userIds	array of integers	No	all users	Filter by submitting user IDs.
submittingStartTimestamp	integer	No	0	Include submissions submitted at or after this Unix timestamp.
submittingEndTime	integer	No	now	Include submissions submitted at or before this Unix timestamp.
limit	integer	No	10	Max results. Range 1–100.
offset	integer	No	0	Pagination offset.

Example — Submissions in a time window

curl --request GET \
  --url 'https://api.connecteam.com/forms/v1/forms/123456789/form-submissions?submittingStartTimestamp=1704067200&submittingEndTime=1706745599&limit=25' \
  --header 'X-API-KEY: YOUR_API_KEY'

PUT — Update Submission

Updates manager fields only on an existing submission. Send the fields to change in the request body.

curl --request PUT \
  --url 'https://api.connecteam.com/forms/v1/forms/123456789/form-submissions/987654321' \
  --header 'X-API-KEY: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{ ... }'

🚧
Manager fields only
PUT does not replace employee-submitted answers. It updates manager-controlled fields on the submission.

Error Codes

HTTP Status	Description
`401`	Missing or invalid authentication.
`403`	Insufficient scope or form permission.
`404`	Form or submission not found.
`422`	Validation error on request body.

Get form submissions API Reference · Update form submission API Reference