Overview

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

Available Endpoints

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.

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

Page	Description
Get Forms	List and retrieve form definitions
Form Submissions	Read and update submissions
Dropdown Options	Manage dropdown question values