> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to Formcarry

The Formcarry connector lets your AI agent act in each user's Formcarry account. Each user connects their own Formcarry access token once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 26 tools.

**Authentication:** Bearer Token
**Categories:** Developer Tools, Productivity
**Tools:** 26: 14 read, 8 write, 4 destructive
**Users sign in with:** Access token
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=FORMCARRY)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the Formcarry connection

   In **AgentKit > Connections**, create a Formcarry connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'formcarry'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Formcarry:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'formcarry_email_servers_list',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "formcarry"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Formcarry:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="formcarry_email_servers_list",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their Formcarry credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'formcarry_email_servers_list',
  toolInput: {},
  connector: 'formcarry',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="formcarry_email_servers_list",
    tool_input={},
    connection_name="formcarry",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `formcarry_email_servers_list`

List Email Servers · Read-only

List the email servers set up in the dashboard for sending notifications: your own SMTP servers (email_server) and verified sending domains (premium_server).
Returns each server's id, type and details.
Use the id as self_email_notification.sender.server_id in Create Form or Update Form.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `formcarry_form_fields_list`

List Form Fields · Read-only

List the field names in the form's newest 2,000 submissions, most used first (up to 200 names).
Returns each field name with how many submissions carry it and when it was last seen.
Use this to pick field names for the fields filter or group_by in submission tools.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `form_id` (`string`, required): ID of the formcarry form, from List Forms or the form's endpoint URL (https://formcarry.com/s/<form_id>). Example: Gx7kZ2pQrS.

Example input: `{"form_id":"<form_id>"}`

### `formcarry_form_get`

Get Form · Read-only

Get one form with its full configuration.
Returns the form's id, name, endpoint URL, active state and storage, spam, notification, auto-response, after-submit and validation settings.
Use this when you know the form ID. Use List Forms to find it.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `form_id` (`string`, required): ID of the formcarry form, from List Forms or the form's endpoint URL (https://formcarry.com/s/<form_id>). Example: Gx7kZ2pQrS.

Example input: `{"form_id":"<form_id>"}`

### `formcarry_forms_list`

List Forms · Read-only

List the forms the API key can access, newest first, each with its full configuration.
Returns data[] of forms with id, name, endpoint URL and settings, plus next_cursor.
Use this to find a form ID. Use Get Form for one form.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `cursor` (`string`, optional): next_cursor from the previous page. Example: eyJpZCI6IjY2NTAifQ.
- `limit` (`integer`, optional): Forms per page, 1 to 100 (default 25). Example: 50.
- `team_id` (`string`, optional): Only forms of this team (one the key covers). Example: 64b000000000000000000001.

Example input: `{}`

### `formcarry_me_get`

Get API Key Details · Read-only

Get the API key used for this connection: its scopes and the teams and forms it can access.
Returns the key's id, scopes and accessible teams and forms.
Use this to check what the key may do before calling other tools.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `formcarry_submission_deliveries_get`

Get Submission Deliveries · Read-only

Get what happened to up to 20 submissions after they arrived: every email, webhook, Zapier zap and integration each was sent to, with the latest outcome.
Returns one row per target and a rolled-up status per submission (null when older than 18 months).
Use this to debug missing notifications. Use List Webhook Deliveries for one webhook's log.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `form_id` (`string`, required): ID of the formcarry form, from List Forms or the form's endpoint URL (https://formcarry.com/s/<form_id>). Example: Gx7kZ2pQrS.
- `submission_ids` (`string`, required): 1 to 20 submission IDs of this form, comma-separated. Example: 6650f0e1d2c3b4a596877766,6650f0e1d2c3b4a596877767.

Example input: `{"form_id":"<form_id>","submission_ids":"<submission_ids>"}`

### `formcarry_submission_get`

Get Submission · Read-only

Get one submission with its fields and uploaded files.
Returns the submission's id, fields, files, status and created_at.
Use this when you know the submission ID. Use List Submissions to find it.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `form_id` (`string`, required): ID of the formcarry form, from List Forms or the form's endpoint URL (https://formcarry.com/s/<form_id>). Example: Gx7kZ2pQrS.
- `submission_id` (`string`, required): ID of the submission, from List Submissions or Search Submissions. Example: 6650f0e1d2c3b4a596877766.

Example input: `{"form_id":"<form_id>","submission_id":"<submission_id>"}`

### `formcarry_submissions_count`

Count Submissions · Read-only

Count one form's submissions matching the same filters as List Submissions, optionally grouped by day, week, month, country, spam, read or a field.
Returns the total or the 20 largest groups plus other, and exact (false when the count timed out).
Use this to size a result before listing.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `form_id` (`string`, required): ID of the formcarry form, from List Forms or the form's endpoint URL (https://formcarry.com/s/<form_id>). Example: Gx7kZ2pQrS.
- `country` (`string`, optional): Only submissions from these countries: two-letter uppercase codes, comma-separated, up to 20. Example: US,CA.
- `created_after` (`string`, optional): Only submissions created at or after this time (RFC 3339 or epoch milliseconds). Example: 2025-01-01T00:00:00Z.
- `created_before` (`string`, optional): Only submissions created before this time (RFC 3339 or epoch milliseconds). Example: 2025-02-01T00:00:00Z.
- `group_by` (`string`, optional): Group the count by day, week, month, country, spam, read or field:<name>. Leave empty for one total. Example: week.
- `has_attachments` (`string`, optional): true for only submissions with uploaded files, false for only those without. Example: true. One of: `true`, `false`.
- `q` (`string`, optional): Only submissions where any field contains this text (case-insensitive, 2 to 512 characters). Example: refund.
- `read` (`string`, optional): true for only submissions read in the dashboard, false for only unread ones. Example: false. One of: `true`, `false`.
- `status` (`string`, optional): Which submissions to include: inbox (default), spam or all. Example: inbox. One of: `inbox`, `spam`, `all`.

Example input: `{"form_id":"<form_id>"}`

### `formcarry_submissions_list`

List Submissions · Read-only

List one form's submissions, newest first, filtered by status, read state, attachments, dates, country or text.
Returns data[] of submissions with id, fields, files and created_at, plus next_cursor (null on the last page).
Use this for one form. Use Search Submissions across forms. Use Count Submissions for totals.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `form_id` (`string`, required): ID of the formcarry form, from List Forms or the form's endpoint URL (https://formcarry.com/s/<form_id>). Example: Gx7kZ2pQrS.
- `country` (`string`, optional): Only submissions from these countries: two-letter uppercase codes, comma-separated, up to 20. Example: US,CA.
- `created_after` (`string`, optional): Only submissions created at or after this time (RFC 3339 or epoch milliseconds). Example: 2025-01-01T00:00:00Z.
- `created_before` (`string`, optional): Only submissions created before this time (RFC 3339 or epoch milliseconds). Example: 2025-02-01T00:00:00Z.
- `cursor` (`string`, optional): next_cursor from the previous page. Example: eyJpZCI6IjY2NTAifQ.
- `fields` (`string`, optional): Only return these submitted fields, comma-separated. Example: email,message.
- `has_attachments` (`string`, optional): true for only submissions with uploaded files, false for only those without. Example: true. One of: `true`, `false`.
- `limit` (`integer`, optional): Submissions per page, 1 to 100 (default 25). Example: 50.
- `order` (`string`, optional): newest (default) or oldest first. Example: oldest. One of: `newest`, `oldest`.
- `q` (`string`, optional): Only submissions where any field contains this text (case-insensitive, 2 to 512 characters). Example: refund.
- `read` (`string`, optional): true for only submissions read in the dashboard, false for only unread ones. Example: false. One of: `true`, `false`.
- `status` (`string`, optional): Which submissions to include: inbox (default), spam or all. Example: inbox. One of: `inbox`, `spam`, `all`.

Example input: `{"form_id":"<form_id>"}`

### `formcarry_submissions_search`

Search Submissions · Read-only

Search submissions across the 25 most recently active forms (or the forms you name), with the same filters as List Submissions.
Returns matches grouped by form, and complete false when not every form or match was reached.
Use this when you do not know the form. Use List Submissions to page through one form.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `country` (`string`, optional): Only submissions from these countries: two-letter uppercase codes, comma-separated, up to 20. Example: US,CA.
- `created_after` (`string`, optional): Only submissions created at or after this time (RFC 3339 or epoch milliseconds). Example: 2025-01-01T00:00:00Z.
- `created_before` (`string`, optional): Only submissions created before this time (RFC 3339 or epoch milliseconds). Example: 2025-02-01T00:00:00Z.
- `fields` (`string`, optional): Only return these submitted fields, comma-separated. Example: email,message.
- `form_ids` (`string`, optional): Search only these form IDs, comma-separated. Example: Gx7kZ2pQrS,Hy8lA3qRsT.
- `has_attachments` (`string`, optional): true for only submissions with uploaded files, false for only those without. Example: true. One of: `true`, `false`.
- `limit` (`integer`, optional): Matches to return in total, 1 to 100 (default 25); this search has no pages. Example: 50.
- `order` (`string`, optional): newest (default) or oldest first. Example: newest. One of: `newest`, `oldest`.
- `q` (`string`, optional): Only submissions where any field contains this text (case-insensitive, 2 to 512 characters). Example: refund.
- `read` (`string`, optional): true for only submissions read in the dashboard, false for only unread ones. Example: false. One of: `true`, `false`.
- `status` (`string`, optional): Which submissions to include: inbox (default), spam or all. Example: inbox. One of: `inbox`, `spam`, `all`.
- `team_id` (`string`, optional): Search this team only. Example: 64b000000000000000000001.

Example input: `{}`

### `formcarry_webhook_deliveries_list`

List Webhook Deliveries · Read-only

List a webhook's delivery log, newest first, one entry per submission with its latest outcome. Kept 18 months.
Returns deliveries with submission id, status, the HTTP status your endpoint returned, error text and occurred_at.
Use Get Webhook Delivery for one submission. Use Redeliver Submission to retry.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `form_id` (`string`, required): ID of the formcarry form, from List Forms or the form's endpoint URL (https://formcarry.com/s/<form_id>). Example: Gx7kZ2pQrS.
- `webhook_id` (`string`, required): ID of the webhook, from List Webhooks or Add Webhook. Example: 6650a1b2c3d4e5f6a7b8c9d0.
- `before` (`string`, optional): Only deliveries before this time: pass the last occurred_at of the previous page. Example: 2025-01-15T10:00:00Z.
- `limit` (`integer`, optional): Deliveries per page, 1 to 100 (default 25). Example: 50.
- `status` (`string`, optional): Only deliveries in this state: succeeded, failed, retrying, pending or skipped. Example: failed. One of: `succeeded`, `failed`, `retrying`, `pending`, `skipped`.

Example input: `{"form_id":"<form_id>","webhook_id":"<webhook_id>"}`

### `formcarry_webhook_delivery_get`

Get Webhook Delivery · Read-only

Get the latest outcome of one submission's delivery to a webhook.
Returns the delivery's status, the HTTP status your endpoint returned, error text and occurred_at.
Use List Webhook Deliveries to browse the log.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `form_id` (`string`, required): ID of the formcarry form, from List Forms or the form's endpoint URL (https://formcarry.com/s/<form_id>). Example: Gx7kZ2pQrS.
- `submission_id` (`string`, required): ID of the submission, from List Submissions or Search Submissions. Example: 6650f0e1d2c3b4a596877766.
- `webhook_id` (`string`, required): ID of the webhook, from List Webhooks or Add Webhook. Example: 6650a1b2c3d4e5f6a7b8c9d0.

Example input: `{"form_id":"<form_id>","submission_id":"<submission_id>","webhook_id":"<webhook_id>"}`

### `formcarry_webhook_get`

Get Webhook · Read-only

Get one webhook of a form, without its secret.
Returns the webhook's id, url, enabled, description and events.
Use List Webhooks to find the webhook ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `form_id` (`string`, required): ID of the formcarry form, from List Forms or the form's endpoint URL (https://formcarry.com/s/<form_id>). Example: Gx7kZ2pQrS.
- `webhook_id` (`string`, required): ID of the webhook, from List Webhooks or Add Webhook. Example: 6650a1b2c3d4e5f6a7b8c9d0.

Example input: `{"form_id":"<form_id>","webhook_id":"<webhook_id>"}`

### `formcarry_webhooks_list`

List Webhooks · Read-only

List a form's webhooks.
Returns data[] with each webhook's id, url, enabled, description and events (the signing secret is not included).
Use this to find a webhook ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `form_id` (`string`, required): ID of the formcarry form, from List Forms or the form's endpoint URL (https://formcarry.com/s/<form_id>). Example: Gx7kZ2pQrS.

Example input: `{"form_id":"<form_id>"}`

### `formcarry_form_create`

Create Form · Write

Create a form, optionally with storage, spam, email notification, auto-response, after-submit and validation settings.
Returns the new form with its id and endpoint URL (https://formcarry.com/s/<id>) to post submissions to.
Settings your plan does not include are refused and no form is created.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): Form name, up to 128 characters. Example: Contact form.
- `active` (`boolean`, optional): Whether the form accepts submissions; inactive forms reject them. Example: true.
- `after_submit` (`object`, optional): What the visitor sees after submitting: type plus either a hosted thank-you page (page) or a redirect URL (redirect). Example: {"page": {"headline": "Thanks!"}}.
- `auto_response` (`object`, optional): The email the person who submitted receives: enabled, subject, from_name, logo_url, logo_height and template. Example: {"enabled": true, "subject": "Thanks for reaching out"}.
- `folder_id` (`string`, optional): Folder to file the form in. Example: 64b000000000000000000010.
- `self_email_notification` (`object`, optional): The email you get on every submission: enabled, recipients (list of addresses), include_spam, subject, logo_url, logo_height, template and sender (server_id from List Email Servers). Example: {"enabled": true, "recipients": ["me@company.com"]}.
- `spam` (`object`, optional): Spam settings: protection (formcarry's built-in filter) and captcha, with a provider (none, recaptcha, hcaptcha or turnstile) and that provider's secret_key. Example: {"protection": true, "captcha": {"provider": "turnstile", "secret_key": "0x4AAAA..."}}.
- `storage` (`object`, optional): Storage settings: store_submissions (false forwards by email and webhook without storing) and keep_for (30_days, 60_days, 90_days, 180_days, 365_days or forever). Example: {"store_submissions": true, "keep_for": "90_days"}.
- `team_id` (`string`, optional): Team that owns the form; needed only when the key covers several teams. Example: 64b000000000000000000001.
- `validation` (`object`, optional): Rules a submission must pass: enabled and rules (a list of field rules). Example: {"enabled": true, "rules": []}.

Example input: `{"name":"<name>"}`

### `formcarry_form_recipient_add`

Add Notification Recipient · Write

Add one address to the list that gets an email on every submission, keeping the others. Adding an existing address changes nothing.
Returns the form's notification settings.
The free plan allows one recipient. To replace the whole list, use Update Form.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `email` (`string`, required): Email address to add. Example: me@company.com.
- `form_id` (`string`, required): ID of the formcarry form, from List Forms or the form's endpoint URL (https://formcarry.com/s/<form_id>). Example: Gx7kZ2pQrS.

Example input: `{"email":"<email>","form_id":"<form_id>"}`

### `formcarry_form_update`

Update Form · Write

Change a form's name, active state or settings. Only what you send changes: nested objects are merged, lists such as recipients and rules are replaced whole.
Returns the updated form.
Use Get Form first to read the current settings.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `form_id` (`string`, required): ID of the formcarry form, from List Forms or the form's endpoint URL (https://formcarry.com/s/<form_id>). Example: Gx7kZ2pQrS.
- `active` (`boolean`, optional): Whether the form accepts submissions; inactive forms reject them. Example: true.
- `after_submit` (`object`, optional): What the visitor sees after submitting: type plus either a hosted thank-you page (page) or a redirect URL (redirect). Example: {"page": {"headline": "Thanks!"}}.
- `auto_response` (`object`, optional): The email the person who submitted receives: enabled, subject, from_name, logo_url, logo_height and template. Example: {"enabled": true, "subject": "Thanks for reaching out"}.
- `folder_id` (`string`, optional): Folder to file the form in. Example: 64b000000000000000000010.
- `name` (`string`, optional): New form name, up to 128 characters. Example: Contact form (EN).
- `self_email_notification` (`object`, optional): The email you get on every submission: enabled, recipients (list of addresses), include_spam, subject, logo_url, logo_height, template and sender (server_id from List Email Servers). Example: {"enabled": true, "recipients": ["me@company.com"]}.
- `spam` (`object`, optional): Spam settings: protection (formcarry's built-in filter) and captcha, with a provider (none, recaptcha, hcaptcha or turnstile) and that provider's secret_key. Example: {"protection": true, "captcha": {"provider": "turnstile", "secret_key": "0x4AAAA..."}}.
- `storage` (`object`, optional): Storage settings: store_submissions (false forwards by email and webhook without storing) and keep_for (30_days, 60_days, 90_days, 180_days, 365_days or forever). Example: {"store_submissions": true, "keep_for": "90_days"}.
- `validation` (`object`, optional): Rules a submission must pass: enabled and rules (a list of field rules). Example: {"enabled": true, "rules": []}.

Example input: `{"form_id":"<form_id>"}`

### `formcarry_submission_restore`

Restore Submission · Write

Move a spam submission back to the inbox.
Returns the updated submission.
Use Mark Submission as Spam for the reverse.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `form_id` (`string`, required): ID of the formcarry form, from List Forms or the form's endpoint URL (https://formcarry.com/s/<form_id>). Example: Gx7kZ2pQrS.
- `submission_id` (`string`, required): ID of the submission, from List Submissions or Search Submissions. Example: 6650f0e1d2c3b4a596877766.

Example input: `{"form_id":"<form_id>","submission_id":"<submission_id>"}`

### `formcarry_submission_spam_mark`

Mark Submission as Spam · Write

Move a submission to spam, so it is left out of lists unless status is spam or all.
Returns the updated submission.
Use Restore Submission to move it back to the inbox.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `form_id` (`string`, required): ID of the formcarry form, from List Forms or the form's endpoint URL (https://formcarry.com/s/<form_id>). Example: Gx7kZ2pQrS.
- `submission_id` (`string`, required): ID of the submission, from List Submissions or Search Submissions. Example: 6650f0e1d2c3b4a596877766.

Example input: `{"form_id":"<form_id>","submission_id":"<submission_id>"}`

### `formcarry_webhook_create`

Add Webhook · Write

Add a webhook that receives every submission of the form as a signed JSON POST. Up to 10 per form, one per URL, on plans with webhooks.
Returns the webhook with its signing secret, shown only in this response.
Store the secret to verify deliveries.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `form_id` (`string`, required): ID of the formcarry form, from List Forms or the form's endpoint URL (https://formcarry.com/s/<form_id>). Example: Gx7kZ2pQrS.
- `url` (`string`, required): HTTPS URL that receives each submission as a JSON POST, up to 2048 characters. Example: https://example.com/hooks/formcarry.
- `description` (`string`, optional): Label for your own reference, up to 128 characters. Example: CRM sync.
- `enabled` (`boolean`, optional): Whether the webhook receives submissions; a disabled webhook keeps its settings. Example: true.
- `events` (`array`, optional): Events to send. Only submission.created exists today. Example: ["submission.created"].

Example input: `{"form_id":"<form_id>","url":"<url>"}`

### `formcarry_webhook_redeliver`

Redeliver Submission · Write

Queue one submission to be sent again to one webhook, freshly signed, even if the webhook is paused.
Returns 202 with confirmation that it was queued, not delivered.
Use Get Webhook Delivery afterwards for the outcome. Your endpoint repeats whatever it does with the submission.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `form_id` (`string`, required): ID of the formcarry form, from List Forms or the form's endpoint URL (https://formcarry.com/s/<form_id>). Example: Gx7kZ2pQrS.
- `submission_id` (`string`, required): ID of the submission, from List Submissions or Search Submissions. Example: 6650f0e1d2c3b4a596877766.
- `webhook_id` (`string`, required): ID of the webhook, from List Webhooks or Add Webhook. Example: 6650a1b2c3d4e5f6a7b8c9d0.

Example input: `{"form_id":"<form_id>","submission_id":"<submission_id>","webhook_id":"<webhook_id>"}`

### `formcarry_webhook_update`

Update Webhook · Write

Change a webhook's URL, enabled state, description or events; the secret stays the same.
Returns the updated webhook.
Only the fields you send change.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `form_id` (`string`, required): ID of the formcarry form, from List Forms or the form's endpoint URL (https://formcarry.com/s/<form_id>). Example: Gx7kZ2pQrS.
- `webhook_id` (`string`, required): ID of the webhook, from List Webhooks or Add Webhook. Example: 6650a1b2c3d4e5f6a7b8c9d0.
- `description` (`string`, optional): Label for your own reference, up to 128 characters. Example: CRM sync.
- `enabled` (`boolean`, optional): Whether the webhook receives submissions; a disabled webhook keeps its settings. Example: true.
- `events` (`array`, optional): Events to send. Only submission.created exists today. Example: ["submission.created"].
- `url` (`string`, optional): New endpoint URL. Example: https://example.com/hooks/formcarry-v2.

Example input: `{"form_id":"<form_id>","webhook_id":"<webhook_id>"}`

### `formcarry_form_delete`

Delete Form · Destructive

Permanently delete a form. Its stored submissions, exports and integrations are kept. This cannot be undone.
Returns a confirmation.
Use Update Form with active false to stop submissions without deleting.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `form_id` (`string`, required): ID of the formcarry form, from List Forms or the form's endpoint URL (https://formcarry.com/s/<form_id>). Example: Gx7kZ2pQrS.

Example input: `{"form_id":"<form_id>"}`

### `formcarry_form_recipient_remove`

Remove Notification Recipient · Destructive

Remove one address from the list that gets an email on every submission, keeping the others.
Returns the form's notification settings.
Use Get Form to see the current recipients.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `email` (`string`, required): Email address to remove. Example: me@company.com.
- `form_id` (`string`, required): ID of the formcarry form, from List Forms or the form's endpoint URL (https://formcarry.com/s/<form_id>). Example: Gx7kZ2pQrS.

Example input: `{"email":"<email>","form_id":"<form_id>"}`

### `formcarry_submission_delete`

Delete Submission · Destructive

Permanently delete a submission. Its uploaded files are not deleted. This cannot be undone.
Returns a confirmation.
Use Mark Submission as Spam to hide it from the inbox instead.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `form_id` (`string`, required): ID of the formcarry form, from List Forms or the form's endpoint URL (https://formcarry.com/s/<form_id>). Example: Gx7kZ2pQrS.
- `submission_id` (`string`, required): ID of the submission, from List Submissions or Search Submissions. Example: 6650f0e1d2c3b4a596877766.

Example input: `{"form_id":"<form_id>","submission_id":"<submission_id>"}`

### `formcarry_webhook_delete`

Delete Webhook · Destructive

Remove a webhook so later submissions are not sent to it; deliveries already queued may still complete.
Returns a confirmation.
Use Update Webhook with enabled false to pause it instead.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `form_id` (`string`, required): ID of the formcarry form, from List Forms or the form's endpoint URL (https://formcarry.com/s/<form_id>). Example: Gx7kZ2pQrS.
- `webhook_id` (`string`, required): ID of the webhook, from List Webhooks or Add Webhook. Example: 6650a1b2c3d4e5f6a7b8c9d0.

Example input: `{"form_id":"<form_id>","webhook_id":"<webhook_id>"}`

## Related

Other Developer Tools connectors ([all 200](/agentkit/connectors/?category=developer-tools)):

- [GitHub](/agentkit/connectors/github/): Scalekit connector, OAuth, 217 tools
- [Datadog](/agentkit/connectors/datadog/): Scalekit connector, API key, 105 tools
- [Linear](/agentkit/connectors/linear/): Scalekit connector, OAuth, 64 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
