# Jotform

Jotform is an online form builder that allows users to create and manage forms for various purposes, including data collection, surveys, and more.

- **Category:** forms & surveys
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 18
- **Triggers:** 0
- **Slug:** `JOTFORM`
- **Version:** 20260312_00

## Tools

### Clone Form

**Slug:** `JOTFORM_CLONE_FORM`

Tool to clone a single form in Jotform. Creates a complete copy of the form with all its questions and settings. Use when you need to duplicate an existing form.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Form ID to clone. This is the unique identifier of the form you want to duplicate. |

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

### Create Label

**Slug:** `JOTFORM_CREATE_LABEL`

Tool to create a new label for organizing forms in Jotform. Use when you need to categorize or group forms with a named label.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Name of the label to create. This is a required field. |
| `color` | string | No | Color code for the label in hexadecimal format (e.g., #F09E39, #FF5733). If not provided, a default color will be assigned by the system. |

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

### Delete Label

**Slug:** `JOTFORM_DELETE_LABEL`

Tool to delete a label along with all its sublabels. Use when you need to remove a label from the account.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Label ID to delete |

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

**Slug:** `JOTFORM_GET_LABEL`

Tool to retrieve details of a label by its ID, including name and color. Use when you need to fetch information about a specific label.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Label ID to retrieve details for |

#### 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 Label Resources

**Slug:** `JOTFORM_GET_LABEL_RESOURCES`

Tool to get a list of assets (forms) in a label and their associated information. Use when you need to retrieve forms organized under a specific label.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Label ID to retrieve resources for |

#### 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 System Plan

**Slug:** `JOTFORM_GET_SYSTEM_PLAN`

Tool to retrieve details of a specific system plan. Use when you need to check limits and pricing of a plan.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `planName` | string ("FREE" | "BRONZE" | "SILVER" | "GOLD" | "PLATINUM") | Yes | Name of the system plan to retrieve. |

#### 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 User Details

**Slug:** `JOTFORM_GET_USER_DETAILS`

Tool to retrieve details of the authenticated user, including account and usage info. Use after confirming valid API key.

#### 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 User Folders

**Slug:** `JOTFORM_GET_USER_FOLDERS`

Tool to retrieve a list of labels (folders replacement) for the authenticated user. Uses the GET /user/labels endpoint per Jotform's migration from folders to labels.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `owner` | string | No | Owner username or workspace/team ID. Conditionally required for some accounts/workspaces. |
| `add_resources` | boolean | No | Include label resources (e.g., forms) in the response when true (addResources=1). |

#### 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 User Forms

**Slug:** `JOTFORM_GET_USER_FORMS`

Tool to retrieve a list of forms created by the authenticated user. Use after setting up API key authentication.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Number of forms to return |
| `folder` | string | No | Filter by folder ID |
| `offset` | integer | No | Offset for pagination |
| `search` | string | No | Search query |
| `orderby` | string | No | Order by field |
| `sorting` | string | No | Sorting direction: 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 User History

**Slug:** `JOTFORM_GET_USER_HISTORY`

Tool to fetch user activity history records. Use when auditing or filtering user actions by type or date.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `date` | string ("lastWeek" | "lastMonth" | "last3Months" | "last6Months" | "lastYear" | "all") | No | Predefined date range to limit history |
| `action` | string | No | Filter history by action type (e.g., userCreation, formUpdate, apiKeyCreated, userLogout) |
| `sortBy` | string ("ASC" | "DESC") | No | Sort order of results |
| `endDate` | string | No | End date (MM/DD/YYYY) to filter history |
| `startDate` | string | No | Start date (MM/DD/YYYY) to filter history |

#### 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 User Reports

**Slug:** `JOTFORM_GET_USER_REPORTS`

Tool to retrieve list of report URLs for all forms in the account. Includes Excel, CSV, printable charts, and embeddable HTML tables.

#### 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 User Settings

**Slug:** `JOTFORM_GET_USER_SETTINGS`

Tool to retrieve the settings of the authenticated user. Use after confirming a valid API key.

#### 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 User Setting By Key

**Slug:** `JOTFORM_GET_USER_SETTINGS_BY_KEY`

Tool to retrieve a specific user setting by key. Use when you need a single setting value like email, timezone, language, or website.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `settingsKey` | string | Yes | The specific user setting key to retrieve. Common keys include: email, timezone, language, website |

#### 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 User Submissions

**Slug:** `JOTFORM_GET_USER_SUBMISSIONS`

Tool to retrieve all submissions for all forms on the account. The answers dictionary contains submission data with question IDs as keys. Use when you need to access submission data across multiple forms.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Number of results in each result set for submission data. Default is 20. Maximum is 1000. |
| `filter` | string | No | Filters the query results to fetch a specific submissions range. Provide as JSON string, example: '{"new":"1"}' to filter only new submissions. |
| `offset` | integer | No | Start of each result set for submission data. Useful for pagination. Default is 0. |
| `orderby` | string | No | Order results by a submission field name: id, form_id, IP, created_at, status, new, flag, updated_at. |

#### 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 User Usage

**Slug:** `JOTFORM_GET_USER_USAGE`

Tool to retrieve monthly usage statistics for the authenticated user. Use to check form submissions, payment forms, SSL submissions, and storage used.

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

### Remove Resources from Label

**Slug:** `JOTFORM_REMOVE_LABEL_RESOURCES`

Tool to remove specified resources (forms) from a label by their IDs and types. Use when you need to unassign forms from a specific label.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier of the label from which resources will be removed |
| `resources` | array | Yes | List of resources (forms) to remove from the label. Each resource must specify an 'id' and 'type' |

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

### Update Label

**Slug:** `JOTFORM_UPDATE_LABEL`

Tool to update an existing label with new name or color settings. Use when you need to modify label properties.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Label ID to update |
| `name` | string | No | New name for the label |
| `color` | string | No | New color for the label in hex format (e.g., #FF5733) |

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

### Update User Settings

**Slug:** `JOTFORM_UPDATE_USER_SETTINGS`

Tool to update user's settings like time zone, language, email, and website. Use when you need to modify user account settings.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Full name of the user |
| `email` | string | No | New email address for the user |
| `company` | string | No | Company name of the user |
| `website` | string | No | New website URL for the user |
| `industry` | string | No | Industry sector of the user |
| `language` | string | No | Preferred language code for the user (e.g., 'en', 'es', 'fr') |
| `time_zone` | string | No | IANA time zone identifier for the user (e.g., 'America/New_York', 'Europe/London') |
| `securityAnswer` | string | No | Answer to the security question |
| `securityQuestion` | string | No | Security question for account recovery |

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