# Byteforms

All-in-one solution for form creation, submission management, and data integration.

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

## Tools

### Create form

**Slug:** `BYTEFORMS_CREATE_FORM`

Creates a new form in ByteForms. Use this to build data collection forms with customizable fields (text, email, phone), styling options (theme, width), and submission rules (limits, deadlines, password protection). Returns the created form with its public_id for sharing.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `body` | array | Yes | List of form fields/components. Each field needs component type, input type, label, page, index, and unique id |
| `name` | string | Yes | Display name of the form (shown to users) |
| `options` | object | No | Options for form creation request. |

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

**Slug:** `BYTEFORMS_DELETE_FORM`

Tool to delete a form by its ID. Use when you need to remove an existing form permanently.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `form_id` | string | Yes | The internal numeric ID of the form to delete. Get this from the 'id' field (not 'public_id') when listing or creating 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 |

### Get All Forms

**Slug:** `BYTEFORMS_GET_ALL_FORMS2`

Tool to fetch all forms created by the authenticated user. Use after authentication to list existing 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 |

### Get Form By ID

**Slug:** `BYTEFORMS_GET_FORM_BY_ID`

Retrieves detailed information about a specific form by its numeric ID. Returns the form's name, fields, configuration options, and metadata. Use the numeric 'id' field (not the 'public_id' string) from form data obtained via BYTEFORMS_GET_ALL_FORMS or BYTEFORMS_CREATE_FORM.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `form_id` | string | Yes | The numeric ID of the form to retrieve (use the 'id' field from form data, not 'public_id') |

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

**Slug:** `BYTEFORMS_GET_FORM_RESPONSES`

Tool to retrieve responses for a specific form with optional pagination and filtering. Use when the form has collected submissions and you need to navigate large result sets.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `after` | string | No | Cursor for pagination — returns items after this cursor |
| `limit` | integer | No | Maximum number of responses to return, must be ≥1 |
| `order` | string ("asc" | "desc") | No | Sort order for responses by creation time |
| `query` | string | No | Filter responses containing this string |
| `before` | string | No | Cursor for pagination — returns items before this cursor |
| `formId` | string | Yes | The numeric ID of the form to retrieve responses for (use the 'id' field from form data, not 'public_id') |

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