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
| Action | What it does |
|---|---|
| Cancel document | Stop a sent document from being signed. |
| Delete document | Delete a document. |
| Download document | Save a document's PDF as a file in Lodol, to attach to an email or store elsewhere. |
| Find documents | Find documents by words in the title or a recipient, by status or by the template they came from. |
| Get document | Get a document's status and where each recipient is up to: sent, opened, signed or rejected. |
| List templates | List the team's templates, with their recipients in order. |
| Resend document | Email the request to sign again to everyone who hasn't signed yet, or to one of them. |
| Send document | Send a draft to its recipients. |
| Send from template | Make a document from a template, fill in who signs and the template's fields, and send it for signature. |
| Send PDF for signature | Send a PDF to be signed. |
Cancel document
Stop a sent document from being signed. It stays in Documenso, marked cancelled.
Inputs
- Document
documenttextRequired - The document, from the list, an earlier step or a trigger, or its ID (envelope_...) or link.
- Reason
reasontext - 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
- Document
documenttextRequired - 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
- Document
documenttextRequired - The document, from the list, an earlier step or a trigger, or its ID (envelope_...) or link.
- Version
versiontext - 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
- Search
searchtext - Words in the title, or a recipient's name or email.
- Status
statustext - Only documents with this status. Leave blank for any.One of:
draft,pending,completed,rejected,cancelled. - Template
templatetext - Only documents made from this template.
- How many
limitnumber - 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
- Document
documenttextRequired - 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
- Search
searchtext - 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
- Document
documenttextRequired - The document, from the list, an earlier step or a trigger, or its ID (envelope_...) or link.
- Only to
recipient_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
- Document
documenttextRequired - The document, from the list, an earlier step or a trigger, or its ID (envelope_...) or link.
- Email subject
subjecttext - The subject of the email asking them to sign. Leave blank for Documenso's.
- Email message
messagetext - A message in the email asking them to sign. Leave blank for Documenso's.
- Email the recipients
email_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
- Template
templatetextRequired - The template, from the list, or its ID (envelope_...) or link.
- Email
recipient_emailtext - The email of the template's first recipient. Leave blank to keep the one the template has.
- Name
recipient_nametext - Their name, shown in the email and on the signed document.
- More recipients
more_recipientslist - The template's next recipients, in its order, one per row, such as Jane Doe <jane@example.com>.
- Fields
field_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.
- Title
titletext - The document's title. Leave blank to use the template's.
- Email subject
subjecttext - The subject of the email asking them to sign. Leave blank for Documenso's.
- Email message
messagetext - A message in the email asking them to sign. Leave blank for Documenso's.
- Email the recipients
email_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 now
sendtrue/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
- PDF
filetextRequired - The PDF: upload it, pick one from an earlier step, or give a public https link.
- Title
titletextRequired - The document's title, as recipients see it.
- Email
recipient_emailtextRequired - The email of the first person to sign.
- Name
recipient_nametext - Their name, shown in the email and on the signed document.
- More recipients
more_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 to
cclist - People who get the signed document but don't sign, one per row, such as Jane Doe <jane@example.com>.
- Signing order
signing_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 subject
subjecttext - The subject of the email asking them to sign. Leave blank for Documenso's.
- Email message
messagetext - A message in the email asking them to sign. Leave blank for Documenso's.
- Email the recipients
email_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 now
sendtrue/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"
]
}