Overview
This n8n node allows you to create a new signature request using the Yousign API. It uploads a document (provided as binary data), specifies one or more signers, and initiates an electronic signature workflow. The node is useful for automating document signing processes, such as sending contracts, agreements, or forms that require signatures from multiple parties.
Practical examples:
- Automate HR onboarding by sending employment contracts for e-signature.
- Streamline sales workflows by sending quotes or agreements to clients for digital signing.
- Integrate with CRM systems to trigger signature requests when deals reach a certain stage.
Properties
| Name | Type | Meaning |
|---|---|---|
| Sandbox | Boolean | Whether to use the Yousign sandbox environment (for testing) or production. |
| Signature Request Name | String | The name/title of the signature request. |
| Signers | Collection | List of signers for this signature request. Each signer requires first name, last name, and email. |
| Signer First Name | String | First name of the signer. |
| Signer Last Name | String | Last name of the signer. |
| Signer Email | String | Email address of the signer (must be valid). |
| Binary Property | String | Name of the binary property containing the file to be uploaded for signing. |
Output
The node returns a JSON array where each item represents the activated signature request created in Yousign. The structure includes all fields returned by the Yousign API for the activated signature request. Typical fields may include:
[
{
"id": "string",
"name": "string",
"status": "string",
"created_at": "string",
"updated_at": "string",
// ...other Yousign signature request fields
}
]
- If the operation fails due to missing or invalid binary data, an error will be thrown.
- No binary output is produced; only JSON data is returned.
Dependencies
- Yousign API: Requires access to the Yousign service.
- API Credentials: You must configure Yousign API credentials in n8n under the name
yousignApi. - Binary Data: The input item must contain a binary property (default:
data) with the file to be signed.
Troubleshooting
Common Issues:
Missing Binary Data:
Error:No binary data exists on item!
Resolution: Ensure the input item contains a binary property with the file to upload.Incorrect Binary Property Name:
Error:No binary data property "<propertyName>" does not exists on item!
Resolution: Check that the specified binary property name matches the property in your input data.Invalid Signer Information:
If required signer fields (first name, last name, email) are missing or invalid, the Yousign API may reject the request.
Resolution: Verify all signer details are provided and emails are valid.Credential Errors:
If API credentials are missing or incorrect, authentication errors will occur.
Resolution: Configure valid Yousign API credentials in n8n.