Overview
The DocuSeal Trigger node is designed to handle webhook events from DocuSeal, a document automation and e-signature platform. It allows n8n workflows to be triggered automatically when specific events occur in your DocuSeal account, such as the creation or completion of submissions. This node is particularly useful for automating processes like updating records, sending notifications, or integrating DocuSeal with other systems whenever relevant document events happen.
Practical examples:
- Automatically notify a team when a submission is completed.
- Sync new DocuSeal submissions to a CRM or database.
- Fetch full submission data for further processing in your workflow.
Properties
| Display Name | Type | Description |
|---|---|---|
| Environment | options | Choose between production and test environment. |
| Event Type | options | The event type to listen to (e.g., All Events, Submission Completed, Submission Created, etc.). Required. |
| Additional Fields | collection | Optional settings. |
| └─ Include Full Submission Data | boolean | Whether to fetch the full submission data when a submission event is received. |
Output
The node outputs a JSON object representing the webhook payload received from DocuSeal. If "Include Full Submission Data" is enabled and the event contains a submission_id, the output will also include a submission_details field with the full submission data fetched from the DocuSeal API.
Example output structure:
{
"event": "submission.completed",
"submission_id": "abc123",
"other_fields": "...",
"submission_details": {
// Full submission data from DocuSeal API (if requested)
}
}
- If "Include Full Submission Data" is not enabled, the output will only contain the original webhook payload fields.
- Binary data is not produced by this node.
Dependencies
- External Service: Requires an active DocuSeal account.
- API Credentials: Needs DocuSeal API credentials (
docusealApi) configured in n8n, including Production and/or Test API keys. - Webhook Setup: You must manually configure a webhook in your DocuSeal dashboard pointing to the URL provided by this node.
Troubleshooting
Common issues:
- Webhook not triggering: Ensure the webhook URL is correctly set up in DocuSeal and matches the one provided by the node.
- Missing or incorrect API credentials: If "Include Full Submission Data" is enabled, valid API keys must be provided; otherwise, fetching submission details will fail.
- Event filtering: If you select a specific event type, only matching events will trigger the workflow. Selecting "All Events" will trigger on any event.
- Error message: "Failed to fetch submission details": This occurs if the node cannot retrieve full submission data (e.g., due to invalid credentials or network issues). Check your API keys and network connectivity.