Send a document for signature
send_for_signatureCreate a document from a template and send it to signers via email for electronic signature. Supports parallel or sequential signing order, idempotent retries, and dry-run validation.
Instructions
Create a document from a template and email it to signers for signature. IMPORTANT: sending exposes the document contents to every listed email — NEVER guess or infer a signer email address. Use exactly the emails the human gave you; if any is missing or ambiguous, ask the human before calling this tool, and restate the recipient list in your confirmation. ARRAY POSITION assigns template roles: the first signer gets the first role, and so on. The document sends as-is — its fields are filled by the signers at signing, not by you. Returns the document id — poll check_status with it. Pass a stable request_id when you might retry: a replayed request returns the original document instead of double-sending. A mis-sent envelope can be voided by the human from the AddSign dashboard (Cancel).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| title | No | Document title; defaults to the template name | |
| dry_run | No | true = validate everything (recipients, template roles, plan limits) and report exactly what WOULD be sent — without creating or emailing anything. Use it to show the human the outcome before the real send. | |
| message | No | Personal note included in the signature-request email | |
| signers | Yes | One signer per template role — array position IS the role assignment | |
| request_id | No | Idempotency key — reuse the same value when retrying after a timeout | |
| template_id | Yes | Template id from list_templates | |
| signing_order_type | No | parallel (default): everyone signs at once; sequential: one at a time in order |