# Formsite

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

- **Category:** forms & surveys
- **Auth:** API_KEY
- **Tools:** 5
- **Triggers:** 0
- **Slug:** `FORMSITE`
- **Version:** 20260211_00

## Tools

### 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, user_dir is 'user123') or in Settings -> Integrations -> Formsite API.

### Get Form Items

**Slug:** `FORMSITE_GET_FORM_ITEMS`

Retrieves all items (questions) for a specific form using the Formsite API. This action returns detailed information about each form item including: - Item ID (unique identifier for the form question) - Position (sequential order in the form) - Label (the question text) - Children (optional, for Matrix and Multi Scale items with sub-items) The item data can be used to label results data by matching item IDs from this action to item IDs from the Get Form Results action. **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, user_dir is 'user123') or in Settings -> Integrations -> Formsite API.

### 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, user_dir is 'user123') or in Settings -> Integrations -> Formsite API.

### 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, user_dir is 'user123') or in Settings -> Integrations -> Formsite API.

### 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, user_dir is 'user123') or in Settings -> Integrations -> Formsite API.
