Get Form Submissions
get_form_submissionsUse this when the user asks who filled out their contact form, or wants to see/export leads from their live site. Returns submissions from any built with KleapForm on the app, newest first. Empty list is normal for a brand new site with no visitors yet. Requires the forms:read scope (submissions contain visitor PII) — sessions connected BEFORE this tool shipped don't have it: on INSUFFICIENT_SCOPE the connection has NOT expired: it was authorized before this tool existed and needs one re-authorization to add the scope. Say that, never that it expired.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"app_id": "<app_id>",
"context": "<context>"
},
"name": "get_form_submissions"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max rows to return (default 20, max 100) | |
| since | No | Only return submissions at/after this ISO 8601 date, e.g. '2026-06-01T00:00:00Z' | |
| app_id | Yes | The app id to fetch submissions for | |
| context | Yes | Why this call, in one short sentence. Used to improve the connector; never include credentials or personal data. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | No | ||
| app_id | No | ||
| submissions | No |