Documenso

App · 10 actions

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.

Actions

ActionWhat it does
Cancel documentStop a sent document from being signed.
Delete documentDelete a document.
Download documentSave a document's PDF as a file in Lodol, to attach to an email or store elsewhere.
Find documentsFind documents by words in the title or a recipient, by status or by the template they came from.
Get documentGet a document's status and where each recipient is up to: sent, opened, signed or rejected.
List templatesList the team's templates, with their recipients in order.
Resend documentEmail the request to sign again to everyone who hasn't signed yet, or to one of them.
Send documentSend a draft to its recipients.
Send from templateMake a document from a template, fill in who signs and the template's fields, and send it for signature.
Send PDF for signatureSend a PDF to be signed.

Cancel document

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

Inputs

DocumentdocumenttextRequired
The document, from the list, an earlier step or a trigger, or its ID (envelope_...) or link.
Reasonreasontext
Why it was cancelled, kept with the document.

Outputs

completed_attext
When everyone had signed (ISO 8601); empty until then
created_attext
When it was made (ISO 8601)
external_idtext
Your own reference on it, if it has one
fileslist
Its PDFs
idtext
The document's ID, such as envelope_kwxzvzesaiwfbxke
linktext
A link to it in Documenso
recipientslist
Who it goes to, in signing order
signed_countnumber
How many signers and approvers have signed
signer_countnumber
How many signers and approvers it has
statustext
draft, pending, completed, rejected or cancelled
titletext
Its title
updated_attext
When it last changed (ISO 8601)
waiting_onlist
Email addresses of the signers still to sign
Example output
{
  "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

DocumentdocumenttextRequired
The document, from the list, an earlier step or a trigger, or its ID (envelope_...) or link.

Outputs

deletedtrue/false
True once deleted
idtext
The document's ID
titletext
Its title
wastext
Its status before it was deleted
Example output
{
  "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

DocumentdocumenttextRequired
The document, from the list, an earlier step or a trigger, or its ID (envelope_...) or link.
Versionversiontext
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_typetext
Its type, application/pdf
document_idtext
The document's ID
document_reftext
The file in Lodol, to pass to a later step
filenametext
The file's name
fileslist
Every file of the document; most have one
size_bytesnumber
Its size in bytes
statustext
The document's status
titletext
The document's title
urltext
A link to the file in Lodol
versiontext
signed, current or original
Example output
{
  "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

Searchsearchtext
Words in the title, or a recipient's name or email.
Statusstatustext
Only documents with this status. Leave blank for any.One of: draft, pending, completed, rejected, cancelled.
Templatetemplatetext
Only documents made from this template.
How manylimitnumber
The most to list. Defaults to 25.From 1 to 100.

Outputs

countnumber
How many are listed
documentslist
The documents found
totalnumber
How many match in all
Example output
{
  "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

DocumentdocumenttextRequired
The document, from the list, an earlier step or a trigger, or its ID (envelope_...) or link.

Outputs

completed_attext
When everyone had signed (ISO 8601); empty until then
created_attext
When it was made (ISO 8601)
external_idtext
Your own reference on it, if it has one
fileslist
Its PDFs
idtext
The document's ID, such as envelope_kwxzvzesaiwfbxke
linktext
A link to it in Documenso
recipientslist
Who it goes to, in signing order
signed_countnumber
How many signers and approvers have signed
signer_countnumber
How many signers and approvers it has
statustext
draft, pending, completed, rejected or cancelled
titletext
Its title
updated_attext
When it last changed (ISO 8601)
waiting_onlist
Email addresses of the signers still to sign
Example output
{
  "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

Searchsearchtext
Words in the template's title. Leave blank for all.

Outputs

countnumber
How many
templateslist
The templates
Example output
{
  "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

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

Outputs

countnumber
How many
document_idtext
The document's ID
resent_tolist
Who it was sent to again
titletext
Its title
Example output
{
  "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

DocumentdocumenttextRequired
The document, from the list, an earlier step or a trigger, or its ID (envelope_...) or link.
Email subjectsubjecttext
The subject of the email asking them to sign. Leave blank for Documenso's.
Email messagemessagetext
A message in the email asking them to sign. Leave blank for Documenso's.
Email the recipientsemail_recipientstrue/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_attext
When everyone had signed (ISO 8601); empty until then
created_attext
When it was made (ISO 8601)
external_idtext
Your own reference on it, if it has one
fileslist
Its PDFs
idtext
The document's ID, such as envelope_kwxzvzesaiwfbxke
linktext
A link to it in Documenso
recipientslist
Who it goes to, in signing order
signature_boxes_added_forlist
Signers who had no signature field, and got a box on the last page
signed_countnumber
How many signers and approvers have signed
signer_countnumber
How many signers and approvers it has
statustext
draft, pending, completed, rejected or cancelled
titletext
Its title
updated_attext
When it last changed (ISO 8601)
waiting_onlist
Email addresses of the signers still to sign
Example output
{
  "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

TemplatetemplatetextRequired
The template, from the list, or its ID (envelope_...) or link.
Emailrecipient_emailtext
The email of the template's first recipient. Leave blank to keep the one the template has.
Namerecipient_nametext
Their name, shown in the email and on the signed document.
More recipientsmore_recipientslist
The template's next recipients, in its order, one per row, such as Jane Doe <jane@example.com>.
Fieldsfield_valuesobject
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.
Titletitletext
The document's title. Leave blank to use the template's.
Email subjectsubjecttext
The subject of the email asking them to sign. Leave blank for Documenso's.
Email messagemessagetext
A message in the email asking them to sign. Leave blank for Documenso's.
Email the recipientsemail_recipientstrue/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 nowsendtrue/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_attext
When everyone had signed (ISO 8601); empty until then
created_attext
When it was made (ISO 8601)
external_idtext
Your own reference on it, if it has one
fileslist
Its PDFs
idtext
The document's ID, such as envelope_kwxzvzesaiwfbxke
linktext
A link to it in Documenso
recipientslist
Who it goes to, in signing order
signature_boxes_added_forlist
Signers who had no signature field, and got a box on the last page
signed_countnumber
How many signers and approvers have signed
signer_countnumber
How many signers and approvers it has
statustext
draft, pending, completed, rejected or cancelled
titletext
Its title
updated_attext
When it last changed (ISO 8601)
waiting_onlist
Email addresses of the signers still to sign
Example output
{
  "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

PDFfiletextRequired
The PDF: upload it, pick one from an earlier step, or give a public https link.
TitletitletextRequired
The document's title, as recipients see it.
Emailrecipient_emailtextRequired
The email of the first person to sign.
Namerecipient_nametext
Their name, shown in the email and on the signed document.
More recipientsmore_recipientslist
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 tocclist
People who get the signed document but don't sign, one per row, such as Jane Doe <jane@example.com>.
Signing ordersigning_ordertext
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 subjectsubjecttext
The subject of the email asking them to sign. Leave blank for Documenso's.
Email messagemessagetext
A message in the email asking them to sign. Leave blank for Documenso's.
Email the recipientsemail_recipientstrue/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 nowsendtrue/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_attext
When everyone had signed (ISO 8601); empty until then
created_attext
When it was made (ISO 8601)
external_idtext
Your own reference on it, if it has one
fileslist
Its PDFs
idtext
The document's ID, such as envelope_kwxzvzesaiwfbxke
linktext
A link to it in Documenso
recipientslist
Who it goes to, in signing order
signature_boxes_added_forlist
Signers who had no signature field, and got a box on the last page
signed_countnumber
How many signers and approvers have signed
signer_countnumber
How many signers and approvers it has
statustext
draft, pending, completed, rejected or cancelled
titletext
Its title
updated_attext
When it last changed (ISO 8601)
waiting_onlist
Email addresses of the signers still to sign
Example output
{
  "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"
  ]
}

On this page