DocuSeal icon

DocuSeal

Create, send, and sign documents

Create Submission From PDF

AI-generated

Summary

Create a DocuSeal signing submission from one or more PDF documents, configure its signers and signing options, and send it to the DocuSeal API. The operation posts to /submissions/pdf and returns the API response for each input item.

Inputs

  • Authentication (required) — Choose Access Token or OAuth2 credentials.
  • Submission Name — Optional name for the submission.
  • Documents (required) — Add PDF documents with required file content (base64-encoded PDF or downloadable URL); optionally set each document name and position.
  • Signers (required) — Add signers with required email and role. Optional settings include name, phone, external ID, metadata, pre-filled field values, auto-sign completion, per-signer email or SMS notifications, two-factor requirements, reply-to address, and completion redirect URL.
  • Send Email — Whether to send email notifications to signers; defaults to true.
  • Send SMS — Whether to send signature requests by SMS; defaults to false.
  • Email Subject and Email Body — Custom notification message; both subject and body must be set for the message to be included.
  • Template IDs — Comma-separated template IDs to merge with the supplied documents; the node splits these into an array.
  • Signers Order — Choose preserved (sequential signer notifications) or random (all parties notified right away); defaults to preserved.
  • BCC Email Address — Address to BCC on signed documents after completion.
  • Reply-To Email Address — Reply-to address for notification emails.
  • Redirect URL — URL to redirect signers to after completion.
  • Expire At — Expiration datetime in ISO 8601 format, after which the submission is unavailable for signing.
  • Flatten — Remove PDF form fields from documents; defaults to false.
  • Merge Documents — Merge documents into one PDF; defaults to false.
  • Remove Tags — Remove {{text}} tags from PDFs; defaults to true.

Output shape

One JSON item per input item, containing the DocuSeal API response for the created submission.

The operation sends non-empty optional values to DocuSeal. Signer field values and metadata are sent as key-value objects; blank keys are omitted.

Links

Discussion