# 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
- **Composio Managed App Available?** N/A
- **Tools:** 5
- **Triggers:** 0
- **Slug:** `FORMSITE`
- **Version:** 20260223_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `form_dir` | string | Yes | 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', the form_dir is 'xyz789'). |
| `user_dir` | string | No | 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `form_dir` | string | Yes | The form's directory/ID to retrieve items from |
| `user_dir` | string | No | 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 | No | Optional. Results Labels ID to apply for item labels |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number if results exceed limit |
| `limit` | integer | No | Maximum number of results to get (1-500, API max is 500) |
| `form_id` | string | Yes | The form directory/ID to fetch results from |
| `user_dir` | string | No | 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") | No | Sort direction for results (asc or desc) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `form_id` | string | Yes | The form directory/ID to fetch webhooks from |
| `user_dir` | string | No | 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_dir` | string | No | 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |