SimplePDF
App · 6 actions
Work with the PDFs in your SimplePDF account: list and rename documents, get a link to the original PDF, read a document's form fields, and list the submissions people have made with the answers they gave.
Actions
| Action | What it does |
|---|---|
| Get document | Get one document with its type and a short-lived link to download the original PDF. |
| Get submission | Get one submission: when it was made, a short-lived link to the filled-in PDF, and the answers given in each field. |
| List document fields | List the form fields set up on a document: each field's id, name, type, page, choices and whether it is required. |
| List documents | List the documents uploaded to your SimplePDF account. |
| List submissions | List the submissions made on a document. |
| Update document | Rename a document or change its type. |
Get document
Get one document with its type and a short-lived link to download the original PDF.
Inputs
- Document
document_idtextRequired - The document. Pick one, or give its id from an earlier step.
Outputs
documentobject- The document
Example output
{
"document": {
"created_at": "2026-10-15T09:00:00Z",
"created_by": {
"details": {
"id": "user_1"
},
"type": "company_user"
},
"embed_url": "https://acme.simplepdf.com/documents/0b3f6c0e",
"id": "0b3f6c0e-6f1c-4c6a-9d1e-0b5b6f4e2a11",
"name": "Employment form.pdf",
"type": "edit_and_submit",
"updated_at": "2026-10-15T09:00:00Z",
"url": "https://files.simplepdf.com/example.pdf?signature=example"
}
}Get submission
Get one submission: when it was made, a short-lived link to the filled-in PDF, and the answers given in each field.
Inputs
- Document
document_idtextRequired - The document. Pick one, or give its id from an earlier step.
- Submission ID
submission_idtextRequired - The submission's id, from 'List submissions'.
Outputs
answerslist- The answers given, one per field
answers_errortext- Why the answers could not be read; otherwise empty
submissionobject- The submission
Example output
{
"answers": [
{
"id": "first_name__widget_1",
"name": "First name",
"value": "Jane"
}
],
"answers_error": "",
"submission": {
"context": {
"customer_id": "123"
},
"field_data_url": "https://files.simplepdf.com/answers.json?signature=example",
"id": "5d2a1e9c-8a7b-4c53-a1f0-6e7d3b9c4f21",
"name": "Employment form.pdf",
"submitted_at": "2026-10-16T10:30:00Z",
"url": "https://files.simplepdf.com/submission.pdf?signature=example"
}
}List document fields
List the form fields set up on a document: each field's id, name, type, page, choices and whether it is required. A document with no fields returns an empty list.
Inputs
- Document
document_idtextRequired - The document. Pick one, or give its id from an earlier step.
Outputs
countnumber- How many fields
fieldslist- The document's form fields
notetext- Why the list is empty, if it is; otherwise empty
Example output
{
"count": 1,
"fields": [
{
"default_value": false,
"id": "first_name__widget_1",
"name": "First name",
"options": null,
"page": 1,
"read_only": false,
"required": true,
"type": "text"
}
],
"note": ""
}List documents
List the documents uploaded to your SimplePDF account. Gets one page; to see more, run it again with the next page it gives.
Inputs
- Page size
limitnumber - How many to return, 1 to 100. SimplePDF's default is 25.From 1 to 100.
- Next page cursor
cursortext - The 'next_cursor' from an earlier page, to get the page after it.
Outputs
countnumber- How many on this page
documentslist- The documents
has_moretrue/false- True when there is another page after this one
next_cursortext- Pass as 'cursor' for the next page; empty on the last one
Example output
{
"count": 1,
"documents": [
{
"created_at": "2026-10-15T09:00:00Z",
"embed_url": "https://acme.simplepdf.com/documents/0b3f6c0e",
"id": "0b3f6c0e-6f1c-4c6a-9d1e-0b5b6f4e2a11",
"name": "Employment form.pdf",
"type": "edit_and_submit",
"updated_at": "2026-10-15T09:00:00Z"
}
],
"has_more": false,
"next_cursor": ""
}List submissions
List the submissions made on a document. Gets one page; to see more, run it again with the next page it gives.
Inputs
- Document
document_idtextRequired - The document. Pick one, or give its id from an earlier step.
- Page size
limitnumber - How many to return, 1 to 100. SimplePDF's default is 25.From 1 to 100.
- Next page cursor
cursortext - The 'next_cursor' from an earlier page, to get the page after it.
Outputs
countnumber- How many on this page
has_moretrue/false- True when there is another page after this one
next_cursortext- Pass as 'cursor' for the next page; empty on the last one
submissionslist- The submissions
Example output
{
"count": 1,
"has_more": false,
"next_cursor": "",
"submissions": [
{
"context": {
"customer_id": "123"
},
"id": "5d2a1e9c-8a7b-4c53-a1f0-6e7d3b9c4f21",
"name": "Employment form.pdf",
"submitted_at": "2026-10-16T10:30:00Z"
}
]
}Update document
Rename a document or change its type. Only the fields you fill in change.
Inputs
- Document
document_idtextRequired - The document. Pick one, or give its id from an earlier step.
- New name
nametext - The document's new name, up to 200 characters.
- Type
document_typetext - Whether people can edit the PDF before submitting it, or only fill it in and submit.One of:
edit_and_submit(Edit and submit),submit(Submit only).
Outputs
documentobject- The document
Example output
{
"document": {
"created_at": "2026-10-15T09:00:00Z",
"created_by": {
"details": {
"id": "user_1"
},
"type": "company_user"
},
"embed_url": "https://acme.simplepdf.com/documents/0b3f6c0e",
"id": "0b3f6c0e-6f1c-4c6a-9d1e-0b5b6f4e2a11",
"name": "Renamed.pdf",
"type": "edit_and_submit",
"updated_at": "2026-10-15T09:00:00Z",
"url": "https://files.simplepdf.com/example.pdf?signature=example"
}
}