---
updatedAt: 2026-06-24T08:24:00.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 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

```bash
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.

```bash
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](https://developer.connecteam.com/reference/get_form_submissions_forms_v1_forms__formid__form_submissions_get) · [Update form submission API Reference](https://developer.connecteam.com/reference/update_form_submission_forms_v1_forms__formid__form_submissions__formsubmissionid__put)