The Forms API lets you read form definitions, retrieve and update submissions, and manage dropdown question options programmatically.
| Method | Endpoint | Description |
|---|
| GET | /forms/v1/forms | List forms for the account |
| GET | /forms/v1/forms/{formId} | Get a single form by ID |
| 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) |
| 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 |
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 |
- List forms — discover
formId values (optionally filter by creation date).
- Get form — load question structure and settings.
- Get submissions — pull submitted answers for a date range or specific users.
- Update submission — write manager-only fields when needed.
- Manage dropdown options — keep selectable values in sync with external systems.
📝Results respect the authenticated admin's form permissions. You only see forms and submissions you are authorized to view.
API Reference
