Actions21
Overview
This node integrates with the PandaDoc API to manage folders within a PandaDoc account. Specifically, the "Folder - Get Many" operation retrieves multiple folders based on optional filtering criteria. This is useful for workflows that need to list or process document folders, organize documents programmatically, or synchronize folder structures between PandaDoc and other systems.
Practical examples include:
- Fetching all folders to display in a UI dropdown.
- Retrieving folders under a specific parent folder to build a folder tree.
- Automating document organization by checking existing folders before creating new ones.
Properties
| Name | Meaning |
|---|---|
| Authentication | Method of authenticating with PandaDoc API: either using an API Key or OAuth2 token. |
| Return All | Whether to return all matching folders or limit the number of results returned. |
| Limit | Maximum number of folders to return if "Return All" is false (minimum 1, default 50). |
| Filters | Optional filters to narrow down the folder search. |
| └ Parent Folder UUID | UUID of the parent folder to retrieve only its child folders. |
Output
The output is an array of JSON objects representing folders retrieved from PandaDoc. Each object contains folder details as returned by the PandaDoc API, such as folder UUID, name, and sharing status. The exact fields depend on the API response but typically include identifiers and metadata about each folder.
No binary data is output by this operation.
Dependencies
- Requires a valid PandaDoc API authentication credential, either an API key or OAuth2 token.
- The node uses the PandaDoc REST API endpoints for folders.
- No additional environment variables are needed beyond the configured credentials.
Troubleshooting
Common issues:
- Invalid or expired API credentials will cause authentication errors.
- Providing an incorrect parent folder UUID filter may result in empty results.
- Exceeding rate limits imposed by PandaDoc API can cause request failures.
Error messages:
"PandaDoc API error: <message>"indicates an issue communicating with the PandaDoc API; check network connectivity and credentials."The operation "getAll" is not supported for resource "folder"!"would occur if the operation name is misspelled or unsupported.
Resolutions:
- Verify API credentials and refresh tokens if using OAuth2.
- Confirm the parent folder UUID exists in your PandaDoc account.
- Handle pagination properly if expecting many folders or set "Return All" accordingly.