> ## Documentation Index
> Fetch the complete documentation index at: https://formpaste.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# send_test_submission

> MCP tool - store a test submission so an agent can prove a form is live. No email, no spam scoring, never counts toward quota.

<Info>**Free** - like the rest of the MCP server, `send_test_submission` is not plan-gated.</Info>

Stores a **test** submission on a form so an agent can prove the form is live and
receiving, without a human filling it in. The test row appears in the owner's inbox with
a **Test** badge. It is store-only: it sends **no** email, runs **no** spam scoring, and
**never** counts toward the monthly quota. Each form keeps only its five newest test rows.

## Input schema

| Field    | Type     | Required | Notes                                                                                                                                    |
| -------- | -------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| `formId` | `string` | yes      | The form to test (`frm_…`), owner-scoped.                                                                                                |
| `fields` | `object` | no       | Sample form fields as a flat string map, e.g. `{ "name": "...", "email": "...", "message": "..." }`. Omit to use a default test payload. |

## Example call

```json theme={null}
{
  "name": "send_test_submission",
  "arguments": {
    "formId": "frm_...",
    "fields": { "name": "Test User", "email": "test@example.com", "message": "Testing the form." }
  }
}
```

## Returned shape

```json theme={null}
{
  "submission_id": "sub_...",
  "is_test": true,
  "stored": true,
  "note": "Test submission stored (no email sent). Visible in your Inbox with a Test badge."
}
```

## What it does NOT do

* **No email** is sent - not to the destination, not an autoresponder, nothing. This
  protects deliverability: an agent can never make Formpaste email a real or test address.
* **No spam scoring** - the row is stored as received directly.
* **No quota impact** - test rows never count toward your monthly submission limit.

## Errors

A `formId` that doesn't exist, or isn't owned by the account behind the token, returns:

```
not_found: no form with that id on your account
```

An empty `fields` object, or a payload over the field-count/size caps, returns
`invalid_input`, `too_many_fields`, or `field_too_large` respectively. An invalid or
revoked token returns the same auth error as every MCP tool - see
[MCP server](/docs/agents/mcp-server#auth).

<CardGroup cols={2}>
  <Card title="get_form" icon="magnifying-glass" href="/docs/agents/get-form">
    Verify the form's config alongside a test submission.
  </Card>

  <Card title="Cookbook prompts" icon="book" href="/docs/agents/cookbook-prompts">
    Ready-to-use prompts that create, wire, and verify a form end to end.
  </Card>
</CardGroup>