The Documenso connector lets your AI agent act in each user's Documenso account. Each user connects their own Documenso API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 29 tools.
- Tools
- 29
- What they doRead · write · destructive
- 8 · 13 · 88 read13 write8 destructive
- Users sign in with
- API key
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Documenso connection
In AgentKit > Connections, create a Documenso connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'documenso'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize Documenso:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'documenso_envelopes_list',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "documenso"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize Documenso:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="documenso_envelopes_list",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user opens the link once and enters their Documenso credentials there. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_tooldocumenso_attachments_listList the link attachments of an envelope (supporting documents shown to recipients).Read-onlyList Envelope Attachments
List the link attachments of an envelope (supporting documents shown to recipients). Returns each attachment's ID, label and URL.
Inputs
envelope_idstringrequired- ID of the envelope (document or template). Get it from documenso_envelopes_list. Example: envelope_7f3c1a2b9d4e5f60718293a4.
documenso_envelope_audit_log_listList the audit log of an envelope: views, signatures, emails and changes.Read-onlyList Envelope Audit Log
List the audit log of an envelope: views, signatures, emails and changes. Returns each event's type, actor, time and data, with paging.
Inputs
envelope_idstringrequired- ID of the envelope (document or template). Get it from documenso_envelopes_list. Example: envelope_7f3c1a2b9d4e5f60718293a4.
order_by_columnstring- Column to sort by. Example: createdAt.one of
createdAt order_by_directionstring- Sort direction. Example: desc.one of
ascdesc pagenumber- Page number, starting at 1. Example: 1.
per_pagenumber- Results per page, up to 100. Example: 20.
documenso_envelope_getGet one envelope with its items (PDFs), recipients, fields and settings.Read-onlyGet Envelope
Get one envelope with its items (PDFs), recipients, fields and settings. Returns the envelope's title, type, status, items, recipients with signing status, fields and meta. Use documenso_envelopes_list to find the ID.
Inputs
envelope_idstringrequired- ID of the envelope (document or template). Get it from documenso_envelopes_list. Example: envelope_7f3c1a2b9d4e5f60718293a4.
documenso_envelopes_get_manyGet up to 20 envelopes at once by their numeric document or template IDs.Read-onlyGet Multiple Envelopes
Get up to 20 envelopes at once by their numeric document or template IDs. Returns the matching envelopes. Use documenso_envelope_get for a single envelope ID.
Inputs
idsobjectrequired- Which IDs to look up: an object with type (documentId or templateId) and ids, a list of up to 20 numbers. Example: {"type": "documentId", "ids": [101, 102]}.
documenso_envelopes_listList envelopes (documents and templates), with a text search, type, status, folder and template filters, and paging.Read-onlyList Envelopes
List envelopes (documents and templates), with a text search, type, status, folder and template filters, and paging. Returns each envelope's ID, title, type, status, recipients and dates, plus paging totals. Use documenso_envelope_get for one envelope's items, recipients and fields.
Inputs
folder_idstring- Only envelopes in this folder. Get it from documenso_folders_list. Example: folder_abc123.
has_expired_recipientsstring- true for envelopes with expired recipients. Example: false.one of
truefalse order_by_columnstring- Column to sort by. Example: createdAt.one of
createdAt order_by_directionstring- Sort direction. Example: desc.one of
ascdesc pagenumber- Page number, starting at 1. Example: 1.
per_pagenumber- Results per page, up to 100. Example: 20.
querystring- Text to search in titles and recipient emails. Example: NDA.
sourcestring- How the document was created. Example: DOCUMENT.one of
DOCUMENTTEMPLATETEMPLATE_DIRECT_LINK statusstring- Only envelopes with this status. Example: PENDING.one of
DRAFTPENDINGCOMPLETEDREJECTEDCANCELLED template_idnumber- Only documents created from this template ID. Example: 42.
typestring- DOCUMENT or TEMPLATE. Example: DOCUMENT.one of
DOCUMENTTEMPLATE
documenso_field_getGet one field (signature, text, date and so on) of an envelope.Read-onlyGet Field
Get one field (signature, text, date and so on) of an envelope. Returns the field's type, recipient, page, position, size and settings.
Inputs
field_idnumberrequired- Numeric ID of the field. Get it from documenso_envelope_get. Example: 501.
documenso_folders_listList document or template folders, with a search, parent filter and paging.Read-onlyList Folders
List document or template folders, with a search, parent filter and paging. Returns each folder's ID, name, type and parent.
Inputs
pagenumber- Page number, starting at 1. Example: 1.
parent_idstring- Only folders inside this folder. Example: folder_root123.
per_pagenumber- Results per page, up to 100. Example: 20.
querystring- Text to search folder names. Example: Contracts.
typestring- DOCUMENT or TEMPLATE. Example: DOCUMENT.one of
DOCUMENTTEMPLATE
documenso_recipient_getGet one recipient of an envelope.Read-onlyGet Recipient
Get one recipient of an envelope. Returns the recipient's email, name, role, signing order, status and fields.
Inputs
recipient_idnumberrequired- Numeric ID of the recipient. Get it from documenso_envelope_get. Example: 301.
documenso_attachment_createAdd a link attachment to an envelope, shown to recipients as a supporting document.WriteAdd Envelope Attachment
Add a link attachment to an envelope, shown to recipients as a supporting document. Returns the new attachment.
Inputs
dataobjectrequired- The attachment: label (shown to recipients) and data (the URL). Example: {"label": "Price list", "data": "https://example.com/prices.pdf"}.
envelope_idstringrequired- ID of the envelope (document or template). Get it from documenso_envelopes_list. Example: envelope_7f3c1a2b9d4e5f60718293a4.
documenso_attachment_updateChange an attachment's label or URL.WriteUpdate Envelope Attachment
Change an attachment's label or URL. Returns the updated attachment.
Inputs
dataobjectrequired- New label and URL. Example: {"label": "Price list 2026", "data": "https://example.com/prices-2026.pdf"}.
idstringrequired- ID of the attachment. Get it from documenso_attachments_list. Example: attachment_abc123.
documenso_envelope_distributeSend a draft document to its recipients for signing.WriteSend Envelope
Send a draft document to its recipients for signing. Returns the envelope with recipient signing links. Add recipients and fields first with documenso_recipients_create and documenso_fields_create.
Inputs
envelope_idstringrequired- ID of the envelope (document or template). Get it from documenso_envelopes_list. Example: envelope_7f3c1a2b9d4e5f60718293a4.
metaobject- Optional email settings for this send, such as subject, message, distributionMethod (EMAIL to email recipients, NONE to only return links), redirectUrl, timezone, dateFormat and language. Example: {"subject": "Please sign", "message": "Hi, please sign the NDA."}.
documenso_envelope_duplicateCopy an envelope into a new draft, optionally with its recipients, fields and file contents.WriteDuplicate Envelope
Copy an envelope into a new draft, optionally with its recipients, fields and file contents. Returns the new envelope's ID. Use it to start a new document from a template envelope, then documenso_envelope_distribute to send it.
Inputs
envelope_idstringrequired- ID of the envelope (document or template). Get it from documenso_envelopes_list. Example: envelope_7f3c1a2b9d4e5f60718293a4.
include_contentsboolean- true to copy the PDF contents. Example: true.
include_fieldsboolean- true to copy the fields. Example: true.
include_recipientsboolean- true to copy the recipients. Example: true.
documenso_envelope_items_updateRename or reorder the PDF items in an envelope.WriteUpdate Envelope Items
Rename or reorder the PDF items in an envelope. Returns the updated items.
Inputs
dataarrayrequired- Items to change: each has envelopeItemId and an optional title and order. Example: [{"envelopeItemId": "envelope_item_abc", "title": "Main agreement", "order": 1}].
envelope_idstringrequired- ID of the envelope (document or template). Get it from documenso_envelopes_list. Example: envelope_7f3c1a2b9d4e5f60718293a4.
documenso_envelope_redistributeResend the signing email to selected recipients of a pending document.WriteResend Envelope
Resend the signing email to selected recipients of a pending document. Returns a success flag. Use documenso_envelope_get to find recipient IDs.
Inputs
envelope_idstringrequired- ID of the envelope (document or template). Get it from documenso_envelopes_list. Example: envelope_7f3c1a2b9d4e5f60718293a4.
recipientsarrayrequired- Numeric IDs of the recipients to email again. Example: [301].
documenso_envelope_updateUpdate an envelope's title, external ID, visibility, folder or access settings, and its email and signing options.WriteUpdate Envelope
Update an envelope's title, external ID, visibility, folder or access settings, and its email and signing options. Returns the updated envelope. Only the fields you pass change.
Inputs
envelope_idstringrequired- ID of the envelope (document or template). Get it from documenso_envelopes_list. Example: envelope_7f3c1a2b9d4e5f60718293a4.
dataobject- Envelope properties to change, such as title, externalId, visibility, folderId, globalAccessAuth or globalActionAuth. Example: {"title": "NDA - Acme", "externalId": "crm-123"}.
metaobject- Email and signing options, such as subject, message, timezone, dateFormat, distributionMethod (EMAIL or NONE), signingOrder (PARALLEL or SEQUENTIAL), redirectUrl and language. Example: {"subject": "Please sign", "message": "Hi, please sign the NDA.", "signingOrder": "SEQUENTIAL"}.
documenso_fields_createAdd signature, initials, date, text and other fields for recipients on a draft envelope's pages.WriteAdd Fields
Add signature, initials, date, text and other fields for recipients on a draft envelope's pages. Returns the created fields with their IDs. Place each field by page and position (percent of the page), or by a placeholder text found in the PDF.
Inputs
dataarrayrequired- Fields to add. Each needs type (CHECKBOX, DATE, DROPDOWN, EMAIL, FREE_SIGNATURE, INITIALS, NAME, NUMBER, RADIO, SIGNATURE, TEXT) and recipientId, plus either page with positionX, positionY, width and height in percent of the page, or a placeholder text to find in the PDF (set matchAll to place it at every match). envelopeItemId picks the PDF when the envelope has several. fieldMeta holds type-specific settings such as label, required or dropdown values. Example: [{"type": "SIGNATURE", "recipientId": 301, "page": 1, "positionX": 60, "positionY": 80, "width": 25, "height": 6}].
envelope_idstringrequired- ID of the envelope (document or template). Get it from documenso_envelopes_list. Example: envelope_7f3c1a2b9d4e5f60718293a4.
documenso_fields_updateMove, resize or change settings of fields on a draft envelope.WriteUpdate Fields
Move, resize or change settings of fields on a draft envelope. Returns the updated fields.
Inputs
dataarrayrequired- Fields to change: each has the numeric id and type, plus the page, position, size or fieldMeta to change. Example: [{"id": 501, "type": "SIGNATURE", "positionX": 55, "positionY": 82}].
envelope_idstringrequired- ID of the envelope (document or template). Get it from documenso_envelopes_list. Example: envelope_7f3c1a2b9d4e5f60718293a4.
documenso_folder_createCreate a folder for documents or templates.WriteCreate Folder
Create a folder for documents or templates. Returns the new folder.
Inputs
namestringrequired- Folder name. Example: Contracts 2026.
parent_idstring- ID of the parent folder, for a subfolder. Example: folder_root123.
typestring- DOCUMENT or TEMPLATE. Example: DOCUMENT.one of
DOCUMENTTEMPLATE
documenso_folder_updateRename or move a folder, or change its visibility.WriteUpdate Folder
Rename or move a folder, or change its visibility. Returns the updated folder.
Inputs
dataobjectrequired- Changes, such as name, parentId or visibility. Example: {"name": "Contracts (signed)"}.
folder_idstringrequired- ID of the folder. Get it from documenso_folders_list. Example: folder_abc123.
documenso_recipients_createAdd one or more recipients (signers, approvers, viewers, CCs or assistants) to a draft envelope.WriteAdd Recipients
Add one or more recipients (signers, approvers, viewers, CCs or assistants) to a draft envelope. Returns the created recipients with their IDs. Add their signature fields afterwards with documenso_fields_create.
Inputs
dataarrayrequired- Recipients to add: each has email, name and role (SIGNER, APPROVER, VIEWER, CC or ASSISTANT), and optionally signingOrder and accessAuth/actionAuth lists. Example: [{"email": "jane@example.com", "name": "Jane Doe", "role": "SIGNER", "signingOrder": 1}].
envelope_idstringrequired- ID of the envelope (document or template). Get it from documenso_envelopes_list. Example: envelope_7f3c1a2b9d4e5f60718293a4.
documenso_recipients_updateUpdate recipients of a draft envelope: email, name, role or signing order.WriteUpdate Recipients
Update recipients of a draft envelope: email, name, role or signing order. Returns the updated recipients.
Inputs
dataarrayrequired- Recipients to change: each has the numeric id and the fields to change. Example: [{"id": 301, "name": "Jane Smith", "role": "APPROVER"}].
envelope_idstringrequired- ID of the envelope (document or template). Get it from documenso_envelopes_list. Example: envelope_7f3c1a2b9d4e5f60718293a4.
documenso_attachment_deleteDelete a link attachment from an envelope.DestructiveDelete Envelope Attachment
Delete a link attachment from an envelope. Returns a success flag.
Inputs
idstringrequired- ID of the attachment. Get it from documenso_attachments_list. Example: attachment_abc123.
documenso_envelope_cancelCancel a pending document so recipients can no longer sign it.DestructiveCancel Envelope
Cancel a pending document so recipients can no longer sign it. Returns a success flag.
Inputs
envelope_idstringrequired- ID of the envelope (document or template). Get it from documenso_envelopes_list. Example: envelope_7f3c1a2b9d4e5f60718293a4.
reasonstring- Reason shown in the audit log. Example: Terms changed; a new version follows.
documenso_envelope_deleteDelete an envelope (document or template).DestructiveDelete Envelope
Delete an envelope (document or template). Returns a success flag. Use documenso_envelope_cancel to stop a pending document but keep its record.
Inputs
envelope_idstringrequired- ID of the envelope (document or template). Get it from documenso_envelopes_list. Example: envelope_7f3c1a2b9d4e5f60718293a4.
documenso_envelope_item_deleteRemove one PDF item from a draft envelope.DestructiveDelete Envelope Item
Remove one PDF item from a draft envelope. Returns a success flag.
Inputs
envelope_idstringrequired- ID of the envelope (document or template). Get it from documenso_envelopes_list. Example: envelope_7f3c1a2b9d4e5f60718293a4.
envelope_item_idstringrequired- ID of the item. Get it from documenso_envelope_get. Example: envelope_item_abc.
documenso_field_deleteDelete a field from a draft envelope.DestructiveDelete Field
Delete a field from a draft envelope. Returns a success flag.
Inputs
field_idnumberrequired- Numeric ID of the field. Get it from documenso_envelope_get. Example: 501.
documenso_folder_deleteDelete a folder.DestructiveDelete Folder
Delete a folder. Returns a success flag.
Inputs
folder_idstringrequired- ID of the folder. Get it from documenso_folders_list. Example: folder_abc123.
documenso_recipient_deleteRemove a recipient from a draft envelope.DestructiveRemove Recipient
Remove a recipient from a draft envelope. Returns a success flag.
Inputs
recipient_idnumberrequired- Numeric ID of the recipient. Get it from documenso_envelope_get. Example: 301.
documenso_recipient_rejectReject a pending document on behalf of one of its recipients, with a reason.DestructiveReject on Behalf of Recipient
Reject a pending document on behalf of one of its recipients, with a reason. Returns a success flag. The document stops for every recipient.
Inputs
envelope_idstringrequired- ID of the envelope (document or template). Get it from documenso_envelopes_list. Example: envelope_7f3c1a2b9d4e5f60718293a4.
reasonstringrequired- Reason for rejecting. Example: Signed on paper instead.
recipient_idnumberrequired- Numeric ID of the recipient. Get it from documenso_envelope_get. Example: 301.
act_as_emailstring- Email of the team member to act as, if needed. Example: admin@acme.com.
No tools match.