signature_request_add_document
Adds a document to a draft signature request. Use fileUrl for automatic upload, or upload manually via the returned presigned URL.
Instructions
Adds a document to a DRAFT signature request. Requires: signature_request_create → requestId, case_file_create → caseFileId. Provide a string id for the document. Compute SHA-256 hex hash of the PDF before calling. Optional: pass fileUrl (a publicly accessible URL) to have the tool download and upload the file to S3 automatically — no separate PUT needed. If fileUrl is omitted, returns url (presigned S3 upload URL) for manual PUT. Cannot add documents after activate_signature_request is called. For CONFIGURABLE sequence: groupId must reference a Document type group (not Signatory or DocumentSignatory) — passing a wrong group type returns 'Signature group not found'.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | UUID for the document — becomes documentId for coordinate_set and certificate_get | |
| hash | Yes | SHA-256 hex digest of the PDF content (64 hex chars) | |
| title | Yes | Document title shown to signatories | |
| fileUrl | No | Optional public URL to download and auto-upload the PDF to S3. Eliminates the manual PUT step. | |
| groupId | No | For CONFIGURABLE sequence: ID of a Document type group | |
| fileName | Yes | File name including extension (e.g. contract.pdf) | |
| fileSize | No | File size in bytes (optional) | |
| requestId | Yes | UUID of the signature request (DRAFT) | |
| caseFileId | Yes | UUID of the case file | |
| convertToPdf | No | Convert non-PDF to PDF before processing |