# Documenso

> Send documents for e-signature with Documenso, the open-source signing app: from a template or a PDF, then follow each signer, remind them and save the signed PDF. Start a workflow when a document is completed, signed or rejected.

App · 10 actions. Web page: https://docs.lodol.com/docs/integrations/documenso

## Actions

### Cancel document

Stop a sent document from being signed. It stays in Documenso, marked cancelled.

**Inputs**

- Document (`document`, text, required): The document, from the list, an earlier step or a trigger, or its ID (envelope_...) or link.
- Reason (`reason`, text): Why it was cancelled, kept with the document.

**Outputs**

- `completed_at` (text): When everyone had signed (ISO 8601); empty until then
- `created_at` (text): When it was made (ISO 8601)
- `external_id` (text): Your own reference on it, if it has one
- `files` (list): Its PDFs
- `id` (text): The document's ID, such as envelope_kwxzvzesaiwfbxke
- `link` (text): A link to it in Documenso
- `recipients` (list): Who it goes to, in signing order
- `signed_count` (number): How many signers and approvers have signed
- `signer_count` (number): How many signers and approvers it has
- `status` (text): draft, pending, completed, rejected or cancelled
- `title` (text): Its title
- `updated_at` (text): When it last changed (ISO 8601)
- `waiting_on` (list): Email addresses of the signers still to sign

**Example output**

```json
{
  "completed_at": "",
  "created_at": "2026-11-05T09:12:00.000Z",
  "external_id": "",
  "files": [
    {
      "id": "envelope_item_mmyidzyfudinsost",
      "title": "agreement.pdf"
    }
  ],
  "id": "envelope_xclfayfmytxztevv",
  "link": "https://app.documenso.com/t/acme/documents/envelope_xclfayfmytxztevv",
  "recipients": [
    {
      "email": "jane@example.com",
      "id": 41,
      "name": "Jane Doe",
      "opened": false,
      "rejection_reason": "",
      "role": "signer",
      "sent": true,
      "signed_at": "",
      "signing_order": 1,
      "signing_url": "https://app.documenso.com/sign/0UwJOkMLVUonKtM899Ill",
      "status": "waiting"
    }
  ],
  "signed_count": 0,
  "signer_count": 1,
  "status": "cancelled",
  "title": "Service agreement - Acme Ltd",
  "updated_at": "2026-11-05T09:12:04.000Z",
  "waiting_on": []
}
```

### Delete document

Delete a document. A draft is gone for good; a sent document is withdrawn from its recipients and taken off your list.

**Inputs**

- Document (`document`, text, required): The document, from the list, an earlier step or a trigger, or its ID (envelope_...) or link.

**Outputs**

- `deleted` (true/false): True once deleted
- `id` (text): The document's ID
- `title` (text): Its title
- `was` (text): Its status before it was deleted

**Example output**

```json
{
  "deleted": true,
  "id": "envelope_xclfayfmytxztevv",
  "title": "Service agreement - Acme Ltd",
  "was": "draft"
}
```

### Download document

Save a document's PDF as a file in Lodol, to attach to an email or store elsewhere. The signed PDF includes Documenso's signing record.

**Inputs**

- Document (`document`, text, required): The document, from the list, an earlier step or a trigger, or its ID (envelope_...) or link.
- Version (`version`, text): Signed by everyone (once it is completed), as it is now with the signatures so far, or the original. One of: `signed` (Signed by everyone), `current` (As it is now), `original` (Original, as sent). Default: `signed`.

**Outputs**

- `content_type` (text): Its type, application/pdf
- `document_id` (text): The document's ID
- `document_ref` (text): The file in Lodol, to pass to a later step
- `filename` (text): The file's name
- `files` (list): Every file of the document; most have one
- `size_bytes` (number): Its size in bytes
- `status` (text): The document's status
- `title` (text): The document's title
- `url` (text): A link to the file in Lodol
- `version` (text): signed, current or original

**Example output**

```json
{
  "content_type": "application/pdf",
  "document_id": "envelope_xclfayfmytxztevv",
  "document_ref": "doc_6f1d3c1e58a14c879a4b2f5e",
  "filename": "agreement_signed.pdf",
  "files": [
    {
      "content_type": "application/pdf",
      "document_ref": "doc_6f1d3c1e58a14c879a4b2f5e",
      "filename": "agreement_signed.pdf",
      "size_bytes": 84211,
      "url": "/actions/core/serve-document/doc_6f1d3c1e58a14c879a4b2f5e?teamId=65f0c0ffee0000000000abcd"
    }
  ],
  "size_bytes": 84211,
  "status": "completed",
  "title": "Service agreement - Acme Ltd",
  "url": "/actions/core/serve-document/doc_6f1d3c1e58a14c879a4b2f5e?teamId=65f0c0ffee0000000000abcd",
  "version": "signed"
}
```

### Find documents

Find documents by words in the title or a recipient, by status or by the template they came from. Newest first.

**Inputs**

- Search (`search`, text): Words in the title, or a recipient's name or email.
- Status (`status`, text): Only documents with this status. Leave blank for any. One of: `draft`, `pending`, `completed`, `rejected`, `cancelled`.
- Template (`template`, text): Only documents made from this template.
- How many (`limit`, number): The most to list. Defaults to 25. From 1 to 100.

**Outputs**

- `count` (number): How many are listed
- `documents` (list): The documents found
- `total` (number): How many match in all

**Example output**

```json
{
  "count": 1,
  "documents": [
    {
      "completed_at": "",
      "created_at": "2026-11-05T09:12:00.000Z",
      "external_id": "",
      "files": [
        {
          "id": "envelope_item_mmyidzyfudinsost",
          "title": "agreement.pdf"
        }
      ],
      "id": "envelope_xclfayfmytxztevv",
      "link": "https://app.documenso.com/t/acme/documents/envelope_xclfayfmytxztevv",
      "recipients": [
        {
          "email": "jane@example.com",
          "id": 41,
          "name": "Jane Doe",
          "opened": false,
          "rejection_reason": "",
          "role": "signer",
          "sent": true,
          "signed_at": "",
          "signing_order": 1,
          "signing_url": "https://app.documenso.com/sign/0UwJOkMLVUonKtM899Ill",
          "status": "waiting"
        }
      ],
      "signed_count": 0,
      "signer_count": 1,
      "status": "pending",
      "title": "Service agreement - Acme Ltd",
      "updated_at": "2026-11-05T09:12:04.000Z",
      "waiting_on": [
        "jane@example.com"
      ]
    }
  ],
  "total": 1
}
```

### Get document

Get a document's status and where each recipient is up to: sent, opened, signed or rejected.

**Inputs**

- Document (`document`, text, required): The document, from the list, an earlier step or a trigger, or its ID (envelope_...) or link.

**Outputs**

- `completed_at` (text): When everyone had signed (ISO 8601); empty until then
- `created_at` (text): When it was made (ISO 8601)
- `external_id` (text): Your own reference on it, if it has one
- `files` (list): Its PDFs
- `id` (text): The document's ID, such as envelope_kwxzvzesaiwfbxke
- `link` (text): A link to it in Documenso
- `recipients` (list): Who it goes to, in signing order
- `signed_count` (number): How many signers and approvers have signed
- `signer_count` (number): How many signers and approvers it has
- `status` (text): draft, pending, completed, rejected or cancelled
- `title` (text): Its title
- `updated_at` (text): When it last changed (ISO 8601)
- `waiting_on` (list): Email addresses of the signers still to sign

**Example output**

```json
{
  "completed_at": "",
  "created_at": "2026-11-05T09:12:00.000Z",
  "external_id": "",
  "files": [
    {
      "id": "envelope_item_mmyidzyfudinsost",
      "title": "agreement.pdf"
    }
  ],
  "id": "envelope_xclfayfmytxztevv",
  "link": "https://app.documenso.com/t/acme/documents/envelope_xclfayfmytxztevv",
  "recipients": [
    {
      "email": "jane@example.com",
      "id": 41,
      "name": "Jane Doe",
      "opened": false,
      "rejection_reason": "",
      "role": "signer",
      "sent": true,
      "signed_at": "",
      "signing_order": 1,
      "signing_url": "https://app.documenso.com/sign/0UwJOkMLVUonKtM899Ill",
      "status": "waiting"
    }
  ],
  "signed_count": 0,
  "signer_count": 1,
  "status": "pending",
  "title": "Service agreement - Acme Ltd",
  "updated_at": "2026-11-05T09:12:04.000Z",
  "waiting_on": [
    "jane@example.com"
  ]
}
```

### List templates

List the team's templates, with their recipients in order.

**Inputs**

- Search (`search`, text): Words in the template's title. Leave blank for all.

**Outputs**

- `count` (number): How many
- `templates` (list): The templates

**Example output**

```json
{
  "count": 1,
  "templates": [
    {
      "created_at": "2026-10-01T10:00:00.000Z",
      "id": "envelope_kwxzvzesaiwfbxke",
      "link": "https://app.documenso.com/t/acme/templates/envelope_kwxzvzesaiwfbxke",
      "recipients": [
        {
          "email": "",
          "id": 4,
          "name": "",
          "role": "signer"
        }
      ],
      "title": "Service agreement",
      "updated_at": "2026-10-01T10:00:00.000Z"
    }
  ]
}
```

### Resend document

Email the request to sign again to everyone who hasn't signed yet, or to one of them.

**Inputs**

- Document (`document`, text, required): The document, from the list, an earlier step or a trigger, or its ID (envelope_...) or link.
- Only to (`recipient_email`, text): One recipient's email, to remind only them. Leave blank for everyone who hasn't signed.

**Outputs**

- `count` (number): How many
- `document_id` (text): The document's ID
- `resent_to` (list): Who it was sent to again
- `title` (text): Its title

**Example output**

```json
{
  "count": 1,
  "document_id": "envelope_xclfayfmytxztevv",
  "resent_to": [
    "jane@example.com"
  ],
  "title": "Service agreement - Acme Ltd"
}
```

### Send document

Send a draft to its recipients. A signer with no signature field gets a box at the foot of the last page.

**Inputs**

- Document (`document`, text, required): The document, from the list, an earlier step or a trigger, or its ID (envelope_...) or link.
- Email subject (`subject`, text): The subject of the email asking them to sign. Leave blank for Documenso's.
- Email message (`message`, text): A message in the email asking them to sign. Leave blank for Documenso's.
- Email the recipients (`email_recipients`, true/false): On: Documenso emails each recipient a link to sign. Off: it sends nothing, and you share each recipient's signing link from the result. Default: `true`.

**Outputs**

- `completed_at` (text): When everyone had signed (ISO 8601); empty until then
- `created_at` (text): When it was made (ISO 8601)
- `external_id` (text): Your own reference on it, if it has one
- `files` (list): Its PDFs
- `id` (text): The document's ID, such as envelope_kwxzvzesaiwfbxke
- `link` (text): A link to it in Documenso
- `recipients` (list): Who it goes to, in signing order
- `signature_boxes_added_for` (list): Signers who had no signature field, and got a box on the last page
- `signed_count` (number): How many signers and approvers have signed
- `signer_count` (number): How many signers and approvers it has
- `status` (text): draft, pending, completed, rejected or cancelled
- `title` (text): Its title
- `updated_at` (text): When it last changed (ISO 8601)
- `waiting_on` (list): Email addresses of the signers still to sign

**Example output**

```json
{
  "completed_at": "",
  "created_at": "2026-11-05T09:12:00.000Z",
  "external_id": "",
  "files": [
    {
      "id": "envelope_item_mmyidzyfudinsost",
      "title": "agreement.pdf"
    }
  ],
  "id": "envelope_xclfayfmytxztevv",
  "link": "https://app.documenso.com/t/acme/documents/envelope_xclfayfmytxztevv",
  "recipients": [
    {
      "email": "jane@example.com",
      "id": 41,
      "name": "Jane Doe",
      "opened": false,
      "rejection_reason": "",
      "role": "signer",
      "sent": true,
      "signed_at": "",
      "signing_order": 1,
      "signing_url": "https://app.documenso.com/sign/0UwJOkMLVUonKtM899Ill",
      "status": "waiting"
    }
  ],
  "signature_boxes_added_for": [],
  "signed_count": 0,
  "signer_count": 1,
  "status": "pending",
  "title": "Service agreement - Acme Ltd",
  "updated_at": "2026-11-05T09:12:04.000Z",
  "waiting_on": [
    "jane@example.com"
  ]
}
```

### Send from template

Make a document from a template, fill in who signs and the template's fields, and send it for signature.

**Inputs**

- Template (`template`, text, required): The template, from the list, or its ID (envelope_...) or link.
- Email (`recipient_email`, text): The email of the template's first recipient. Leave blank to keep the one the template has.
- Name (`recipient_name`, text): Their name, shown in the email and on the signed document.
- More recipients (`more_recipients`, list): The template's next recipients, in its order, one per row, such as Jane Doe <jane@example.com>.
- Fields (`field_values`, object): Values to put in the template's fields before it is sent. Leave a field empty for the signer to fill. For checkboxes, separate the choices with commas.
- Title (`title`, text): The document's title. Leave blank to use the template's.
- Email subject (`subject`, text): The subject of the email asking them to sign. Leave blank for Documenso's.
- Email message (`message`, text): A message in the email asking them to sign. Leave blank for Documenso's.
- Email the recipients (`email_recipients`, true/false): On: Documenso emails each recipient a link to sign. Off: it sends nothing, and you share each recipient's signing link from the result. Default: `true`.
- Send now (`send`, true/false): On: send it straight away. Off: keep it as a draft in Documenso, to check before sending it with 'Send document'. Default: `true`.

**Outputs**

- `completed_at` (text): When everyone had signed (ISO 8601); empty until then
- `created_at` (text): When it was made (ISO 8601)
- `external_id` (text): Your own reference on it, if it has one
- `files` (list): Its PDFs
- `id` (text): The document's ID, such as envelope_kwxzvzesaiwfbxke
- `link` (text): A link to it in Documenso
- `recipients` (list): Who it goes to, in signing order
- `signature_boxes_added_for` (list): Signers who had no signature field, and got a box on the last page
- `signed_count` (number): How many signers and approvers have signed
- `signer_count` (number): How many signers and approvers it has
- `status` (text): draft, pending, completed, rejected or cancelled
- `title` (text): Its title
- `updated_at` (text): When it last changed (ISO 8601)
- `waiting_on` (list): Email addresses of the signers still to sign

**Example output**

```json
{
  "completed_at": "",
  "created_at": "2026-11-05T09:12:00.000Z",
  "external_id": "",
  "files": [
    {
      "id": "envelope_item_mmyidzyfudinsost",
      "title": "agreement.pdf"
    }
  ],
  "id": "envelope_xclfayfmytxztevv",
  "link": "https://app.documenso.com/t/acme/documents/envelope_xclfayfmytxztevv",
  "recipients": [
    {
      "email": "jane@example.com",
      "id": 41,
      "name": "Jane Doe",
      "opened": false,
      "rejection_reason": "",
      "role": "signer",
      "sent": true,
      "signed_at": "",
      "signing_order": 1,
      "signing_url": "https://app.documenso.com/sign/0UwJOkMLVUonKtM899Ill",
      "status": "waiting"
    }
  ],
  "signature_boxes_added_for": [],
  "signed_count": 0,
  "signer_count": 1,
  "status": "pending",
  "title": "Service agreement - Acme Ltd",
  "updated_at": "2026-11-05T09:12:04.000Z",
  "waiting_on": [
    "jane@example.com"
  ]
}
```

### Send PDF for signature

Send a PDF to be signed. Text such as {{signature, r1}} in the PDF becomes a field for the first recipient; a signer with none gets a signature box at the foot of the last page.

**Inputs**

- PDF (`file`, text, required): The PDF: upload it, pick one from an earlier step, or give a public https link.
- Title (`title`, text, required): The document's title, as recipients see it.
- Email (`recipient_email`, text, required): The email of the first person to sign.
- Name (`recipient_name`, text): Their name, shown in the email and on the signed document.
- More recipients (`more_recipients`, list): More people to sign, one per row, such as Jane Doe <jane@example.com>. The first is r2 in the PDF's text fields.
- Copy to (`cc`, list): People who get the signed document but don't sign, one per row, such as Jane Doe <jane@example.com>.
- Signing order (`signing_order`, text): Whether everyone signs at once, or each waits for the one before. One of: `parallel` (All at once), `sequential` (One after another, in order). Default: `parallel`.
- Email subject (`subject`, text): The subject of the email asking them to sign. Leave blank for Documenso's.
- Email message (`message`, text): A message in the email asking them to sign. Leave blank for Documenso's.
- Email the recipients (`email_recipients`, true/false): On: Documenso emails each recipient a link to sign. Off: it sends nothing, and you share each recipient's signing link from the result. Default: `true`.
- Send now (`send`, true/false): On: send it straight away. Off: keep it as a draft in Documenso, to check before sending it with 'Send document'. Default: `true`.

**Outputs**

- `completed_at` (text): When everyone had signed (ISO 8601); empty until then
- `created_at` (text): When it was made (ISO 8601)
- `external_id` (text): Your own reference on it, if it has one
- `files` (list): Its PDFs
- `id` (text): The document's ID, such as envelope_kwxzvzesaiwfbxke
- `link` (text): A link to it in Documenso
- `recipients` (list): Who it goes to, in signing order
- `signature_boxes_added_for` (list): Signers who had no signature field, and got a box on the last page
- `signed_count` (number): How many signers and approvers have signed
- `signer_count` (number): How many signers and approvers it has
- `status` (text): draft, pending, completed, rejected or cancelled
- `title` (text): Its title
- `updated_at` (text): When it last changed (ISO 8601)
- `waiting_on` (list): Email addresses of the signers still to sign

**Example output**

```json
{
  "completed_at": "",
  "created_at": "2026-11-05T09:12:00.000Z",
  "external_id": "",
  "files": [
    {
      "id": "envelope_item_mmyidzyfudinsost",
      "title": "agreement.pdf"
    }
  ],
  "id": "envelope_xclfayfmytxztevv",
  "link": "https://app.documenso.com/t/acme/documents/envelope_xclfayfmytxztevv",
  "recipients": [
    {
      "email": "jane@example.com",
      "id": 41,
      "name": "Jane Doe",
      "opened": false,
      "rejection_reason": "",
      "role": "signer",
      "sent": true,
      "signed_at": "",
      "signing_order": 1,
      "signing_url": "https://app.documenso.com/sign/0UwJOkMLVUonKtM899Ill",
      "status": "waiting"
    }
  ],
  "signature_boxes_added_for": [],
  "signed_count": 0,
  "signer_count": 1,
  "status": "pending",
  "title": "Service agreement - Acme Ltd",
  "updated_at": "2026-11-05T09:12:04.000Z",
  "waiting_on": [
    "jane@example.com"
  ]
}
```
