# Formcarry

Formcarry is a form API that allows you to collect submissions from your own designed HTML forms without coding any backend, providing features like email notifications, file uploads, spam protection, and integrations with other apps.

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

## Tools

### Create Form

**Slug:** `FORMCARRY_CREATE_FORM`

Create a new form with customizable settings including email notifications, webhooks, and thank you pages. This action creates a Formcarry form with extensive configuration options for email notifications (both to form owners and respondents), webhook integrations, Google Recaptcha spam protection, and customizable thank you pages. Use when you need to programmatically set up a new form with specific notification rules or integrations.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Name of the form. This is the identifier you'll use to recognize the form in your Formcarry dashboard. |
| `email` | string | No | Email addresses for self respondent notifications. Separate multiple addresses with comma (e.g., 'admin@example.com,support@example.com'). |
| `failUrl` | string | No | Failed page URL to redirect users after failed submission. Required if returnUrl is present. |
| `webhook` | string | No | Webhook URL. Formcarry will send a POST request to this URL when a new submission is received. |
| `retention` | boolean | No | Save incoming submissions to formcarry database. Default is true. Set to false if you only want to forward submissions via webhook. |
| `returnUrl` | string | No | Thank you page URL to redirect users after successful submission. If provided, failUrl is also required. |
| `autoResponse` | boolean | No | Enable auto-response email notifications to be sent to form respondents. This sends a confirmation email to the person who submitted the form. |
| `returnParams` | boolean | No | Enable sending form message in query string to Return URL. When enabled, form data will be passed as query parameters. |
| `selfEmail_code` | string | No | HTML email template code if selfEmail_theme is Custom. Supports Dynamic Tags for inserting submission data. |
| `selfEmail_from` | string | No | From email address for self email notifications sent to form owner. |
| `googleRecaptcha` | string | No | Google Recaptcha secret key to enable Google Recaptcha spam protection on the form. |
| `selfEmail_theme` | string ("Fancy" | "Formal" | "Custom") | No | Email template theme options. |
| `autoResponse_code` | string | No | HTML code for Custom theme respondent auto-response email. Supports Dynamic Tags for personalization. |
| `autoResponse_from` | string | No | From email address for respondent auto-response notifications. |
| `selfEmail_subject` | string | No | Subject line of self email notifications sent to form owner. |
| `thankYouPage_mode` | string ("Light" | "Dark" | "System") | No | Display mode for the thank you page. |
| `autoResponse_theme` | string ("Fancy" | "Formal" | "Custom") | No | Email template theme options. |
| `thankYouPage_theme` | string ("Fancy" | "Formal" | "Sweet") | No | Theme options for the built-in thank you page. |
| `autoResponse_message` | string | No | Message content for Fancy or Formal theme respondent auto-response emails. |
| `autoResponse_subject` | string | No | Subject line of respondent auto-response email notification. |
| `selfEmail_sendOnSpam` | boolean | No | Send email notifications for submissions marked as spam. Default is false. Enable only if you want to review spam submissions. |
| `thankYouPage_message` | string | No | Message text displayed on the thank you page below the headline. |
| `thankYouPage_headline` | string | No | The headline text displayed at the top of the thank you page. |
| `thankYouPage_returnUrl` | string | No | URL to redirect when user clicks the primary button on the thank you page. |
| `thankYouPage_returnText` | string | No | Text displayed on the primary button of the thank you page. Defaults to 'Return' if not specified. |

#### 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:** `FORMCARRY_DELETE_FORM`

Delete an existing form by its Form ID. Use when you need to permanently remove a form from your Formcarry account.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `formId` | string | Yes | The unique identifier of the form to delete. You can find this in your Formcarry dashboard or by listing forms via the 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 |

### Retrieve Form Submissions

**Slug:** `FORMCARRY_RETRIEVE_SUBMISSIONS`

Retrieves all submissions for a specific Formcarry form. Returns a paginated list of form submissions with their field data, timestamps, and submission IDs. Use pagination parameters to navigate through large submission sets. Default page size is 25, maximum is 50 submissions per page. Useful for: collecting form responses, exporting submission data, integrating form data into other systems, or building custom analytics dashboards.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. Starts from 1. |
| `limit` | integer | No | Number of submissions per page. Default is 25, Max is 50. |
| `formId` | string | Yes | The unique identifier of the form whose submissions you want to retrieve. You can find this in your Formcarry dashboard or by listing forms via the 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 |

### Verify API Key Authentication

**Slug:** `FORMCARRY_VERIFY_AUTH`

Tool to verify API key authentication with Formcarry. Use this endpoint to check if your API key is valid before making other API requests. Returns success status and a confirmation message if the API key is valid.

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