Paperform
App · Forms & Surveys · 5 actions
Read your Paperform forms and the submissions they receive, and look up a form's fields to make sense of its answers.
Actions
| Action | What it does |
|---|---|
| Get a form | Fetch one form's details by its ID or slug. |
| Get a submission | Fetch one submission and its answers. |
| List form fields | List a form's fields, so you can map the keys in a submission's answers back to their questions. |
| List forms | List the forms on your Paperform account. |
| List submissions | List the submissions a form has received. |
Get a form
Fetch one form's details by its ID or slug.
Inputs
- Form ID or slug
form_idtextRequired - The form's ID or slug, as returned by List forms. The slug is the part before .paperform.co in the form's URL.
Outputs
created_attext- When the form was created, in UTC
form_idtext- Form ID. Use with the other Paperform actions.
livetrue/false- Whether the form is currently accepting submissions
slugtext- The form's slug -- its custom slug if one is set, otherwise the generated one. Works anywhere a form ID does.
submission_countnumber- How many submissions the form has received
titletext- The form's title
urltext- The form's public sharing URL
Example output
{
"created_at": "2026-07-14T09:00:00.000Z",
"form_id": "5d40fdaf174b4c0007043072",
"live": true,
"slug": "contact-us",
"submission_count": 128,
"title": "Contact us",
"url": "https://lffa4fxo.paperform.co"
}Get a submission
Fetch one submission and its answers.
Inputs
- Submission ID
submission_idtextRequired - The ID of the submission, as returned by List submissions.
Outputs
answersobject- The answers, keyed by field key -- for example {'abc1': 'Ada Lovelace'}. Use List form fields to map each key to its question.
form_idtext- ID of the form the submission belongs to
submission_idtext- Submission ID. Use with Get a submission.
submitted_attext- When the submission was received, in UTC
Example output
{
"answers": {
"abc1": "Ada Lovelace",
"def2": "ada@example.com"
},
"form_id": "5d40fdaf174b4c0007043072",
"submission_id": "6a21bd9f174b4c000704abcd",
"submitted_at": "2026-07-29T17:04:11.000Z"
}List form fields
List a form's fields, so you can map the keys in a submission's answers back to their questions.
Inputs
- Form ID or slug
form_idtextRequired - The form's ID or slug, as returned by List forms. The slug is the part before .paperform.co in the form's URL.
Outputs
fieldslist- The form's fields
Example output
{
"fields": [
{
"key": "abc1",
"title": "Your name",
"type": "text"
},
{
"key": "def2",
"title": "Your email",
"type": "email"
}
]
}List forms
List the forms on your Paperform account.
Inputs
- Maximum results
limitnumber - How many items to return (1-100).From 1 to 100. Default:
20. - Skip
skipnumber - How many items to skip, for paging past earlier results.At least 0. Default:
0. - Search term
searchtext - Optional. Only return forms whose title matches this text.
Outputs
formslist- The matching forms
has_moretrue/false- Whether more items exist beyond this page
totalnumber- How many items match in total, across all pages
Example output
{
"forms": [
{
"created_at": "2026-07-14T09:00:00.000Z",
"form_id": "5d40fdaf174b4c0007043072",
"live": true,
"slug": "contact-us",
"submission_count": 128,
"title": "Contact us",
"url": "https://lffa4fxo.paperform.co"
}
],
"has_more": true,
"total": 57
}List submissions
List the submissions a form has received.
Inputs
- Form ID or slug
form_idtextRequired - The form's ID or slug, as returned by List forms. The slug is the part before .paperform.co in the form's URL.
- Maximum results
limitnumber - How many items to return (1-100).From 1 to 100. Default:
20. - Skip
skipnumber - How many items to skip, for paging past earlier results.At least 0. Default:
0. - Order
sorttext - Optional. Return oldest or newest submissions first.One of:
ASC(Oldest first),DESC(Newest first).
Outputs
has_moretrue/false- Whether more items exist beyond this page
submissionslist- The matching submissions
totalnumber- How many items match in total, across all pages
Example output
{
"has_more": true,
"submissions": [
{
"answers": {
"abc1": "Ada Lovelace",
"def2": "ada@example.com"
},
"form_id": "5d40fdaf174b4c0007043072",
"submission_id": "6a21bd9f174b4c000704abcd",
"submitted_at": "2026-07-29T17:04:11.000Z"
}
],
"total": 128
}