products.update, webhooks.create and webhooks.delete need the Business API and answer 402 on other plans.
Forms are addressed by slug, custom slug or id (form). Submission answers (data) are keyed by field key; fields.list maps each key to its question title and type. forms.list, spaces.list, translations.list, submissions.list, partialSubmissions.list and webhooks.list return 20 rows by default; page them with limit (up to 100) and skip, or filter with afterDate, beforeDate, afterId and beforeId. fields.list, products.list, coupons.list and spaces.forms return everything in one response.
Only form, space, translation and submission metadata is stored locally. Submission answers, device details and IP addresses are returned to the caller but not stored, and are kept out of events.
Paperform sends space ids as numbers and product prices as strings; the plugin returns ids as strings and prices as sent.
What you get:
- 24 typed API operations
- 4 synced entities (
forms,spaces,submissions,translations) for fast.search()/.list()
Setup
1
Install
2
Add the plugin
corsair.ts
multiTenancy: true, scope calls with corsair.withTenant(id). See Quick start for KEK + Hub keys, and Multi-tenancy for account isolation.3
Choose authentication
- API Key (Recommended)
Store the Paperform API key before the first call: More: API Key
pnpm corsair setup --plugin=paperform --tenant=acme api_key=<your-key> (leave out --tenant without multiTenancy), or pass it as key in the plugin options. With Hub, each tenant enters their own key on the connect page. See API key auth.4
Connect a tenant
Mint a connect link and send the tenant to it. Hub hosts the page and delivers the result to your app — see Connect / OAuth.
Example API calls
List this week’s submissionsQuery synced data
Synced entities supporttenant.paperform.db.<entity>.search() and .list(): forms, spaces, submissions, translations.
See Database for filters and operators.
What’s next
API reference
Every
paperform.api.* operation with input and output types.Database
Synced entities, search filters, and operators.
Connect / OAuth
createLink, Hub delivery, and tenant connect flows.
Use with agents
Expose this plugin’s operations as MCP tools.