> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Formsite

> Formsite helps users create online forms and surveys with drag-and-drop tools, secure data capture, and integrations to simplify workflows

![Formsite logo](https://mintcdn.com/composio-preview/GL28i3tBlbEbBd-f/images/toolkits/formsite.svg?fit=max\&auto=format\&n=GL28i3tBlbEbBd-f\&q=85\&s=927cd2cafbaefc5ce2eb160379d4ae45)

* **Category:** forms & surveys
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 5
* **Triggers:** 0
* **Slug:** `FORMSITE`
* **Version:** 20261101\_00

## Tools

> [accordion] Get Form Details
>
> **Slug:** `FORMSITE_GET_FORM`
>
> This tool retrieves detailed information about a specific form in Formsite. It provides comprehensive details including the form's internal description, directory identifier, name, publishing information (embed code and form link), current state (e.g., "open"), and statistics (file size and number of results). **Important**: If the connection's base\_url doesn't include the user directory, you must provide the 'user\_dir' parameter. Find this in your Formsite form URLs (e.g., if URL is [https://fs8.formsite.com/user123/forms/abc](https://fs8.formsite.com/user123/forms/abc), user\_dir is 'user123') or in Settings -> Integrations -> Formsite API.
>
> #### Input Parameters
>
> **form\_dir** `string` *required*
>
> The form's directory identifier (also called form ID). This can be found in your form's URL after '/forms/' (e.g., in '[https://fs8.formsite.com/abc123/forms/xyz789](https://fs8.formsite.com/abc123/forms/xyz789)', the form\_dir is 'xyz789').
>
> **user\_dir** `string`
>
> The user directory for your Formsite account. If not provided, it will be extracted from the base\_url. You can find this in your form URLs (e.g., if your form URL contains '/vSkOfz/forms/', your user\_dir is 'vSkOfz') or in Settings -> Integrations -> Formsite API.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Form Items
>
> **Slug:** `FORMSITE_GET_FORM_ITEMS`
>
> Retrieves result-storing items for a specific Formsite form, including IDs, positions, labels and optional children; headings, images and other items that do not store results are excluded. Item IDs can be matched to form results, and an optional Results Labels ID selects the labels to apply.
>
> #### Input Parameters
>
> **form\_dir** `string` *required*
>
> The form's directory/ID to retrieve items from
>
> **user\_dir** `string`
>
> The user directory for your Formsite account. If not provided, it will be extracted from the base\_url. You can find this in your form URLs (e.g., if your form URL contains '/vSkOfz/forms/', your user\_dir is 'vSkOfz') or in Settings -> Integrations -> Formsite API.
>
> **results\_labels** `string`
>
> Optional. Results Labels ID to apply for item labels
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Form Results
>
> **Slug:** `FORMSITE_GET_FORM_RESULTS`
>
> This tool retrieves form results from a specified FormSite form. It uses the GET https\://\{server}.formsite.com/api/v2/\{user\_dir}/forms/\{form\_id}/results endpoint to fetch results, handling required parameters such as form\_id, user\_dir, limit, page, and sort direction. **Important**: If the connection's base\_url doesn't include the user directory, you must provide the 'user\_dir' parameter. Find this in your Formsite form URLs (e.g., if URL is [https://fs8.formsite.com/user123/forms/abc](https://fs8.formsite.com/user123/forms/abc), user\_dir is 'user123') or in Settings -> Integrations -> Formsite API.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number if results exceed limit
>
> **limit** `integer`
>
> Maximum number of results to get (1-500, API max is 500)
>
> **form\_id** `string` *required*
>
> The form directory/ID to fetch results from
>
> **user\_dir** `string`
>
> The user directory for your Formsite account. If not provided, it will be extracted from the base\_url. You can find this in your form URLs (e.g., if your form URL contains '/vSkOfz/forms/', your user\_dir is 'vSkOfz') or in Settings -> Integrations -> Formsite API.
>
> **sort\_direction** `string ("asc" | "desc")`
>
> Sort direction for results (asc or desc)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Form Webhooks
>
> **Slug:** `FORMSITE_GET_WEBHOOKS`
>
> Retrieves all webhooks configured for a specific form in FormSite. This action returns webhook configurations including URL, event type (e.g., 'result\_completed'), and optional handshake\_key for security. Webhooks notify external URLs when form events occur. **Important**: If the connection's base\_url doesn't include the user directory, you must provide the 'user\_dir' parameter. Find this in your Formsite form URLs (e.g., if URL is [https://fs8.formsite.com/user123/forms/abc](https://fs8.formsite.com/user123/forms/abc), user\_dir is 'user123') or in Settings -> Integrations -> Formsite API.
>
> #### Input Parameters
>
> **form\_id** `string` *required*
>
> The form directory/ID to fetch webhooks from
>
> **user\_dir** `string`
>
> The user directory for your Formsite account. If not provided, it will be extracted from the base\_url. You can find this in your form URLs (e.g., if your form URL contains '/vSkOfz/forms/', your user\_dir is 'vSkOfz') or in Settings -> Integrations -> Formsite API.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List All Forms
>
> **Slug:** `FORMSITE_LIST_ALL_FORMS`
>
> Retrieves a list of all forms in the user's Formsite account. This action returns detailed information about each form including: - Form directory (identifier for accessing the form via API) - Form name (the display name of the form) - Description (optional internal description) - Publish information (embed code and public link) - State (open/closed status) - Statistics (file storage size and results count) The form directory returned by this action can be used with other Formsite actions like Get Form Details, Get Form Items, and Get Form Results. **Important**: If the connection's base\_url doesn't include the user directory, you must provide the 'user\_dir' parameter. Find this in your Formsite form URLs (e.g., if URL is [https://fs8.formsite.com/user123/forms/abc](https://fs8.formsite.com/user123/forms/abc), user\_dir is 'user123') or in Settings -> Integrations -> Formsite API.
>
> #### Input Parameters
>
> **user\_dir** `string`
>
> The user directory for your Formsite account. If not provided, it will be extracted from the base\_url. You can find this in your form URLs (e.g., if your form URL contains '/vSkOfz/forms/', your user\_dir is 'vSkOfz') or in Settings -> Integrations -> Formsite API.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
