DocuSeal icon

DocuSeal

Create documents, manage templates, and handle submissions with DocuSeal

Actions9

Overview

The DocuSeal - Template: Get operation node retrieves detailed information about a specific template from the DocuSeal platform using its unique Template ID. This is useful for workflows that need to fetch template metadata, structure, or configuration before creating document submissions or for auditing and management purposes.

Common scenarios:

  • Fetching template details to display in dashboards or forms.
  • Validating template existence before initiating a submission.
  • Synchronizing template data between DocuSeal and other systems.

Example use case:
A workflow step that, given a Template ID, pulls all relevant information about that template to allow users to select fields or preview the template before sending documents for signing.

Properties

Display Name Type Description
Environment options Choose between production and test environment.
Template ID number ID of the template to retrieve (required).

Output

The output will be a JSON object containing the details of the requested template. The exact structure depends on the DocuSeal API response, but typically includes:

{
  "id": 123,
  "name": "NDA Agreement",
  "description": "Standard NDA template",
  "fields": [
    {
      "name": "Full Name",
      "type": "text",
      "required": true
    }
    // ... more fields
  ],
  "created_at": "2023-01-01T12:00:00Z",
  "updated_at": "2023-02-01T12:00:00Z"
  // ... additional template metadata
}
  • All data is returned under the json property of each output item.
  • No binary data is produced by this operation.

Dependencies

  • External Service: Requires access to the DocuSeal API.
  • Credentials: You must configure DocuSeal API credentials in n8n (docusealApi).
  • Environment Variable: None required beyond standard n8n credential setup.

Troubleshooting

Common issues:

  • Invalid Template ID: If the provided Template ID does not exist, the node may return an error such as Template not found or a similar message from the DocuSeal API.
  • Authentication errors: If credentials are missing or incorrect, you may see errors like 401 Unauthorized.
  • Network/API errors: Issues with connectivity to the DocuSeal API endpoint can result in timeout or network-related errors.

How to resolve:

  • Double-check the Template ID for typos or ensure it exists in your DocuSeal account.
  • Verify that your DocuSeal API credentials are correctly set up in n8n.
  • Ensure your n8n instance has internet access and can reach the DocuSeal API.

Links and References

Discussion