Actions21
Overview
This node integrates with a project management service to retrieve data about projects, clients, or people. Specifically, for the "Projects" resource and the "Get All" operation, it fetches a list of all projects available in the connected account. This is useful for scenarios where you want to synchronize project lists, generate reports, or trigger workflows based on existing projects.
For example, you might use this node to:
- Retrieve all active projects to display in a dashboard.
- Fetch all projects to automate status updates or notifications.
- Integrate project data into other systems like CRMs or time tracking tools.
Properties
| Name | Meaning |
|---|---|
| Only Active | Boolean flag indicating whether to return only active projects (true) or all projects (false). |
| Options | A collection placeholder for additional optional parameters (currently empty in definition). |
Note: The "Only Active" property applies when fetching projects, allowing filtering by active status.
Output
The node outputs an array of JSON objects representing projects. Each object contains the project's details as returned by the external API. The exact structure depends on the API response but typically includes fields such as project ID, name, status, start/end dates, and other metadata.
No binary data output is indicated in the source code.
Dependencies
- Requires connection to the external project management API via an authenticated API client initialized in the base class.
- The node relies on an API key or authentication token configured in n8n credentials (referred generically).
- No additional environment variables are explicitly required beyond standard API authentication.
Troubleshooting
- Unsupported Resource Error: If a resource other than "projects", "clients", or "people" is selected, the node throws an error stating the resource is unsupported. Ensure the resource parameter is set correctly.
- API Connection Issues: Failures in connecting to the external API may cause errors. Verify that the API credentials are valid and have sufficient permissions.
- Empty Results: If no projects are returned, check if the "Only Active" filter is excluding all projects; try disabling it to fetch all projects.
- Continue On Fail Behavior: If enabled, the node returns error messages within the output JSON instead of failing the workflow, which can help in debugging.
Links and References
- Refer to the external project management service's official API documentation for detailed information on project data fields and filtering options.
- n8n documentation on creating and configuring API credentials for secure access.