DocuSeal icon

DocuSeal

Create documents, manage templates, and handle submissions with DocuSeal

Actions23

Overview

The node integrates with the DocuSeal API to manage document templates, including updating existing templates. Specifically, the "Template - Update" operation allows users to modify properties of a template such as its external ID, folder location, or name. This is useful in scenarios where templates need to be maintained or reorganized without recreating them from scratch.

Practical examples:

  • Renaming a template to reflect updated branding.
  • Moving a template to a different folder for better organization.
  • Assigning or updating an external identifier used in other systems.

Properties

Name Meaning
Template ID The unique numeric identifier of the template to update.
Template Name The new name for the template (required when creating or cloning, optional for update).
Update Fields A collection of fields that can be updated:
- External ID A string to set or update the external identifier associated with the template.
- Folder Name or ID The folder name or ID where the template should be placed or moved.
- Name The new name to assign to the template.

Output

The output JSON contains the response from the DocuSeal API after updating the template. Typically, this includes the updated template object with its current properties reflecting the changes made.

No binary data output is produced by this operation.

Dependencies

  • Requires an active connection to the DocuSeal API via an API key credential configured in n8n.
  • The node uses internal helper functions to make HTTP requests and handle binary data preparation if needed (not applicable for update).
  • No additional environment variables are required beyond the API authentication setup.

Troubleshooting

  • Error: "At least one field must be updated"
    Occurs if the "Update Fields" collection is empty. To fix, ensure at least one property (external ID, folder, or name) is provided for update.

  • Invalid Template ID
    If the provided Template ID does not exist or is invalid, the API will return an error. Verify the Template ID is correct.

  • API Request Failures
    Network issues or invalid API credentials can cause request failures. Confirm the API key is valid and the network connection is stable.

  • Permission Issues
    Insufficient permissions on the DocuSeal account may prevent updates. Ensure the API key has rights to modify templates.

Links and References

Discussion