---
canonical_url: "https://docs.composio.dev/toolkits/formcrafts"
markdown_url: "https://docs.composio.dev/toolkits/formcrafts.md"
product: "platform"
version: null
last_updated: null
---

# Formcrafts

Formcrafts is an online form builder for collecting responses, managing forms, and accessing uploaded files across an organization.

- **Category:** forms & surveys
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 6
- **Triggers:** 0
- **Slug:** `FORMCRAFTS`
- **Version:** 00000000_00

## Tools

### Download File

**Slug:** `FORMCRAFTS_DOWNLOAD_FILE`

Download an uploaded Formcrafts file by file ID and return an offloaded file reference.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `file_id` | string | Yes | File ID returned by FORMCRAFTS_LIST_FILES or by a file-upload field in FORMCRAFTS_LIST_FORM_RESPONSES. |

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

**Slug:** `FORMCRAFTS_GET_FORM`

Get a Formcrafts form's metadata, response count, fields, and pages by form ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `form_id` | string | Yes | Form ID returned by FORMCRAFTS_LIST_FORMS. |

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

**Slug:** `FORMCRAFTS_LIST_FILES`

Return one page of files uploaded to the connected Formcrafts organization. Use before and after for exclusive created_at windows; inspect has_more because Formcrafts provides no continuation token.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `after` | string | No | Return files created strictly after this YYYY-MM-DD or ISO 8601 boundary; may be combined with before for a bounded window. |
| `limit` | integer | No | Maximum files to return (1-100). |
| `before` | string | No | Return files created strictly before this YYYY-MM-DD or ISO 8601 boundary. |

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

**Slug:** `FORMCRAFTS_LIST_FORM_RESPONSES`

Return one page of live responses for a Formcrafts form, including visitor metadata, workflow results, and typed field values. Use before and after for exclusive created_at windows; inspect has_more because Formcrafts provides no continuation token.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `after` | string | No | Return responses created strictly after this YYYY-MM-DD or ISO 8601 boundary; may be combined with before for a bounded window. |
| `limit` | integer | No | Maximum live responses to return (1-100). |
| `before` | string | No | Return responses created strictly before this YYYY-MM-DD or ISO 8601 boundary. |
| `form_id` | string | Yes | Form ID returned by FORMCRAFTS_LIST_FORMS. |

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

**Slug:** `FORMCRAFTS_LIST_FORMS`

Return one page of forms from the connected Formcrafts organization. Use before and after for exclusive created_at windows; inspect has_more because Formcrafts provides no continuation token.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `after` | string | No | Return forms created strictly after this YYYY-MM-DD or ISO 8601 boundary; may be combined with before for a bounded window. |
| `limit` | integer | No | Maximum forms to return (1-100). |
| `before` | string | No | Return forms created strictly before this YYYY-MM-DD or ISO 8601 boundary. |

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

**Slug:** `FORMCRAFTS_LIST_WORKSPACES`

Return one page of workspaces from the connected Formcrafts organization. Use before and after for exclusive created_at windows; inspect has_more because Formcrafts provides no continuation token.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `after` | string | No | Return workspaces created strictly after this YYYY-MM-DD or ISO 8601 boundary; may be combined with before for a bounded window. |
| `limit` | integer | No | Maximum workspaces to return (1-100). |
| `before` | string | No | Return workspaces created strictly before this YYYY-MM-DD or ISO 8601 boundary. |

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