DocuSeal icon

DocuSeal

Create documents, manage templates, and handle submissions with DocuSeal

Actions23

Overview

This node interacts with the DocuSeal API to manage document templates, among other resources. Specifically, the Template - Get Many operation retrieves multiple document templates from DocuSeal based on optional filters and a limit on the number of results.

Typical use cases include:

  • Fetching a list of available document templates for display or further processing.
  • Filtering templates by folder, external ID, archived status, or search query to find specific templates.
  • Limiting the number of returned templates to optimize performance or UI display.

For example, you might use this operation to retrieve up to 50 active templates in a particular folder named "Contracts" to present them in a dropdown menu for users to select from.

Properties

Name Meaning
Limit Maximum number of template results to return (minimum 1). Default is 50.
Filters Collection of optional filters to narrow down the templates:
- Archived: Whether to include archived templates (true/false).
- External ID: Filter templates by their external identifier (string).
- Folder Name or ID: Filter templates located in a specific folder by name or ID (string).
- Search Query: Search templates by name using a text query (string).

Output

The output is an array of JSON objects representing the retrieved templates. Each object corresponds to a single template with its properties as returned by the DocuSeal API.

The exact structure of each template object depends on the API response but typically includes identifiers, names, metadata, and status fields.

No binary data is output by this operation.

Dependencies

  • Requires an API key credential for authenticating requests to the DocuSeal API.
  • The node uses internal helper functions to make HTTP GET requests to the /templates endpoint with query parameters derived from the input properties.
  • No additional external dependencies are required beyond the configured API authentication.

Troubleshooting

  • Failed to retrieve templates: This error occurs if the API request fails due to network issues, invalid credentials, or server errors. Check that your API key is valid and has sufficient permissions.
  • Invalid filter values: Ensure that filter inputs such as folder names or external IDs are correctly specified and exist in your DocuSeal account.
  • Limit value too low or missing: The limit must be at least 1; otherwise, the node may throw an error or return no results.
  • If no templates are returned, verify that your filters are not overly restrictive.

Links and References

Discussion