DocuSignInstall

Summary

Locks a DocuSign envelope for editing for a set time (1–1800 seconds), optionally labelled with the name of the app holding the lock.

Inputs

• authentication — Auth method: JWT (Service Integration, default) or OAuth2 (User Authorization).
• envelopeId (required) — ID of the envelope to lock.
• lockDurationInSeconds (required) — How long the lock lasts, in seconds. Minimum 1, maximum 1800 (30 minutes). Default 300.
• lockedByApp — Friendly name of the application holding the lock. Default "n8n".

Output shape

A single JSON item with the lock information returned by the DocuSign API for the envelope (handled by handleEnvelopeLockCreate).

The handler body is not visible in the provided source, so the exact response fields are not confirmed. They are expected to be DocuSign's lock details, such as lock token, duration and holder. Errors, such as an invalid envelope ID or an envelope already locked, surface as node API errors. Requests are retried on rate limits and 5xx errors.

Examples

Example 1: Prevent others from editing an envelope while a workflow modifies it

Envelope ID from a previous node, Lock Duration 600, Locked By App "n8n".

Example 2: Take a short lock before updating recipients or documents

Envelope ID set via expression, Lock Duration 120, default Locked By App.

Links

• n8n community nodes installation guide