---
updatedAt: 2026-06-24T08:24:14.000Z
---

Fetch the complete documentation index at: https://developer.connecteam.com/llms.txt. Use this file to discover all available pages before exploring further.

# Overview

The Forms API lets you read form definitions, retrieve and update submissions, and manage dropdown question options programmatically.

## Available Endpoints

### Forms

| Method | Endpoint                 | Description                |
| :----- | :----------------------- | :------------------------- |
| GET    | /forms/v1/forms          | List forms for the account |
| GET    | /forms/v1/forms/{formId} | Get a single form by ID    |

### Form Submissions

| Method | Endpoint                                                     | Description                               |
| :----- | :----------------------------------------------------------- | :---------------------------------------- |
| GET    | /forms/v1/forms/{formId}/form-submissions                    | List submissions for a form               |
| GET    | /forms/v1/forms/{formId}/form-submissions/{formSubmissionId} | Get a single submission                   |
| PUT    | /forms/v1/forms/{formId}/form-submissions/{formSubmissionId} | Update a submission (manager fields only) |

### Dropdown Questions

| Method | Endpoint                                                           | Description                          |
| :----- | :----------------------------------------------------------------- | :----------------------------------- |
| GET    | /forms/v1/forms/{formId}/questions/{questionId}                    | List dropdown options for a question |
| POST   | /forms/v1/forms/{formId}/questions/{questionId}                    | Add dropdown options                 |
| PUT    | /forms/v1/forms/{formId}/questions/{questionId}/options/{optionId} | Update a dropdown option             |
| DELETE | /forms/v1/forms/{formId}/questions/{questionId}/options/{optionId} | Delete a dropdown option             |

***

## Authentication

All endpoints require an API key or OAuth 2.0.

| Scope        | Operations                                      |
| :----------- | :---------------------------------------------- |
| forms.read   | GET forms, submissions, and dropdown options    |
| forms.write  | POST/PUT dropdown options; PUT form submissions |
| forms.delete | DELETE dropdown options                         |

***

## Typical Workflow

1. **List forms** — discover `formId` values (optionally filter by creation date).
2. **Get form** — load question structure and settings.
3. **Get submissions** — pull submitted answers for a date range or specific users.
4. **Update submission** — write manager-only fields when needed.
5. **Manage dropdown options** — keep selectable values in sync with external systems.

> 📝 Note
>
> Results respect the authenticated admin's form permissions. You only see forms and submissions you are authorized to view.

***

## Guide Pages

| Page                                       | Description                        |
| :----------------------------------------- | :--------------------------------- |
| [Get Forms](forms-get-forms)               | List and retrieve form definitions |
| [Form Submissions](forms-form-submissions) | Read and update submissions        |
| [Dropdown Options](forms-dropdown-options) | Manage dropdown question values    |

***

[API Reference](https://developer.connecteam.com/reference/)