# SimplePDF

> 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.

App · 6 actions. Web page: https://docs.lodol.com/docs/integrations/simplepdf

## Actions

### Get document

Get one document with its type and a short-lived link to download the original PDF.

**Inputs**

- Document (`document_id`, text, required): The document. Pick one, or give its id from an earlier step.

**Outputs**

- `document` (object): The document

**Example output**

```json
{
  "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_id`, text, required): The document. Pick one, or give its id from an earlier step.
- Submission ID (`submission_id`, text, required): The submission's id, from 'List submissions'.

**Outputs**

- `answers` (list): The answers given, one per field
- `answers_error` (text): Why the answers could not be read; otherwise empty
- `submission` (object): The submission

**Example output**

```json
{
  "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_id`, text, required): The document. Pick one, or give its id from an earlier step.

**Outputs**

- `count` (number): How many fields
- `fields` (list): The document's form fields
- `note` (text): Why the list is empty, if it is; otherwise empty

**Example output**

```json
{
  "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 (`limit`, number): How many to return, 1 to 100. SimplePDF's default is 25. From 1 to 100.
- Next page cursor (`cursor`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `count` (number): How many on this page
- `documents` (list): The documents
- `has_more` (true/false): True when there is another page after this one
- `next_cursor` (text): Pass as 'cursor' for the next page; empty on the last one

**Example output**

```json
{
  "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_id`, text, required): The document. Pick one, or give its id from an earlier step.
- Page size (`limit`, number): How many to return, 1 to 100. SimplePDF's default is 25. From 1 to 100.
- Next page cursor (`cursor`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `count` (number): How many on this page
- `has_more` (true/false): True when there is another page after this one
- `next_cursor` (text): Pass as 'cursor' for the next page; empty on the last one
- `submissions` (list): The submissions

**Example output**

```json
{
  "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_id`, text, required): The document. Pick one, or give its id from an earlier step.
- New name (`name`, text): The document's new name, up to 200 characters.
- Type (`document_type`, text): 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**

- `document` (object): The document

**Example output**

```json
{
  "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"
  }
}
```
