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

ActionWhat it does
Get documentGet one document with its type and a short-lived link to download the original PDF.
Get submissionGet one submission: when it was made, a short-lived link to the filled-in PDF, and the answers given in each field.
List document fieldsList the form fields set up on a document: each field's id, name, type, page, choices and whether it is required.
List documentsList the documents uploaded to your SimplePDF account.
List submissionsList the submissions made on a document.
Update documentRename 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

Documentdocument_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

Documentdocument_idtextRequired
The document. Pick one, or give its id from an earlier step.
Submission IDsubmission_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

Documentdocument_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 sizelimitnumber
How many to return, 1 to 100. SimplePDF's default is 25.From 1 to 100.
Next page cursorcursortext
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

Documentdocument_idtextRequired
The document. Pick one, or give its id from an earlier step.
Page sizelimitnumber
How many to return, 1 to 100. SimplePDF's default is 25.From 1 to 100.
Next page cursorcursortext
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

Documentdocument_idtextRequired
The document. Pick one, or give its id from an earlier step.
New namenametext
The document's new name, up to 200 characters.
Typedocument_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"
  }
}

On this page