List form submissions
list_submissionsList what visitors submitted through a site's forms (the Inbox), newest first, with every answer they gave — message, budget, custom questions — alongside name, email and phone. Use it to read, triage, summarise or judge leads ("which look genuine?", "what is this person asking for?"). Filter by Inbox status, form slug, free-text search on email/name, a submitted-at window, or arrival source. Test-mode submissions are left out unless include_test is true. PERSONAL DATA: answer the owner's question with it; do not copy it into site content or anywhere the user did not ask for. Paginated — compare total with limit/offset before concluding you have seen everyone.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| form | No | Only submissions from this form, by its slug (see list_forms) | |
| limit | No | Page size, default 25, max 100 | |
| offset | No | Rows to skip, for paging | |
| search | No | Case-insensitive match on the submitter's email or name | |
| source | No | "web" for the site's own forms, "agent" for enquiries sent by AI agents | |
| status | No | Only submissions in this Inbox status | |
| site_id | Yes | The site, from list_sites | |
| to_date | No | Submitted on or before this ISO date/time | |
| category | No | Only this submission category, when the site defines categories | |
| from_date | No | Submitted on or after this ISO date/time, e.g. "2026-09-01" | |
| user_goal | No | Optional: the user's goal behind this call, in one short sentence of plain words (e.g. "add a page so customers can book tables"). No names, emails or other personal details. | |
| include_test | No | Include submissions made with the editor's test mode (default false) |