# Getform

Getform is a modern form backend platform that enables developers to handle web forms and submissions without setting up a server or writing backend code.

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

## Tools

### Get Form Submission

**Slug:** `GETFORM_GET_FORM_GET_SUBMISSION`

Retrieve a specific form submission by its ID from Getform. Use this tool when you have both a form_id and submission_id and need to fetch the details of that single submission. The response includes all form field values submitted by the user, plus metadata like submission date and any uploaded files. Note: The Getform API does not have a dedicated single-submission endpoint, so this action fetches all submissions and filters by ID. For forms with many submissions, consider using get_submissions with pagination if you need to process multiple records. Prerequisites: - A valid Getform API token that corresponds to the specified form_id - The submission_id must exist for the given form

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `form_id` | string | Yes | The unique identifier of the Getform form. This is the alphanumeric ID visible in your Getform dashboard URL (e.g., 'bkknozrb'). The API token must be valid for this specific form. |
| `submission_id` | string | Yes | The numeric ID of the submission to retrieve. You can obtain this ID from the get_submissions action or from the Getform dashboard. |

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

### Submit Form

**Slug:** `GETFORM_GET_FORM_SUBMIT_FORM`

Tool to submit form data and files to a Getform endpoint. Use when you need to post fields, files, optional reCAPTCHA or honeypot to a specific form ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | No | Key/value pairs representing form fields to submit. |
| `files` | array | No | Optional list of files to upload; will be posted as multipart/form-data |
| `_gotcha` | string | No | Honeypot field value; leave empty (spam filter). |
| `form_id` | string | Yes | Identifier of the Getform form endpoint (as in /f/{form_id}) |
| `accept_json` | boolean | No | Whether to set Accept header to application/json for a JSON response instead of redirect |
| `g-recaptcha-response` | string | No | reCAPTCHA token for spam protection (if enabled on the form). |

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