PandaDoc icon

PandaDoc

Consume PandaDoc API

Overview

This node integrates with the PandaDoc API to retrieve information about folders within a PandaDoc account. Specifically, the "Folder - Get" operation fetches details of a single folder identified by its ID or selected from a searchable list.

Common scenarios where this node is useful include:

  • Organizing documents by retrieving metadata about specific folders.
  • Automating workflows that depend on folder properties or existence.
  • Integrating PandaDoc folder data into other systems or reports.

For example, you might use this node to get details of a shared folder before moving documents into it or to verify folder attributes as part of a document management automation.

Properties

Name Meaning
Authentication Method to authenticate with PandaDoc API:
• API Key
• OAuth2
Folder The folder to retrieve. Can be specified in two ways:
• From List (searchable) — search and select a folder by name
• By ID — provide the folder's unique identifier (must match regex [a-zA-Z0-9-]{16,})

Output

The output is a JSON object representing the folder's details as returned by the PandaDoc API. This typically includes fields such as:

  • uuid: Unique identifier of the folder.
  • name: Folder name.
  • shared: Boolean indicating if the folder is shared.
  • Other metadata like creation date, permissions, etc., depending on the API response.

No binary data is output by this operation.

Dependencies

  • Requires an active PandaDoc account.
  • Requires authentication via either an API key credential or OAuth2 token configured in n8n.
  • The node uses the PandaDoc REST API endpoint /documents/folders to fetch folder data.

Troubleshooting

  • Invalid Folder ID: If the provided folder ID does not match the required pattern or does not exist, the node will throw an error indicating the folder was not found or the ID is invalid. Verify the folder ID format and existence.
  • Authentication Errors: Ensure that the API key or OAuth2 credentials are correctly set up and have sufficient permissions to access folder data.
  • API Rate Limits or Network Issues: Temporary failures may occur due to rate limiting or connectivity problems. Retrying after some time or checking network status can help.
  • Search List Empty: When using the searchable list mode, if no folders appear, confirm that the PandaDoc account has folders created and that the user has access rights.

Links and References

Discussion