Actions101
- Attendance Actions
- Client Actions
- Department Actions
- Designation Actions
- Employee Actions
- Holiday Actions
- KPI Actions
- KPI Category Actions
- KPI Data Actions
- Lead Actions
- Leave Actions
- OKR Key Result Actions
- OKR Objective Actions
- Performance Cycle Actions
- Project Actions
- Project Category Actions
- Task Actions
- Task Category Actions
- Ticket Actions
- Ticket Agent Actions
- Ticket Channel Actions
- Ticket Type Actions
Overview
This node operation retrieves multiple OKR (Objectives and Key Results) objectives from the Flowyteam API. It allows users to fetch a list of objectives filtered by type (Company, Team, or Personal), optionally narrowed down by specific team or person ID, and filtered by performance cycle ID. The results can be sorted by ID or title in ascending or descending order. Users can also choose whether to receive simplified data or the raw API response.
This operation is useful for managers, team leads, or individuals who want to review and analyze multiple objectives within an organization or team context, track progress across performance cycles, or integrate objective data into workflows for reporting or automation.
Practical Examples
- A manager wants to pull all company-wide objectives for the current quarter to generate a status report.
- A team lead needs to retrieve all team-specific objectives for their team to monitor alignment with company goals.
- An individual contributor wants to see their personal objectives for the ongoing performance cycle.
Properties
| Name | Meaning |
|---|---|
| Type | Filter objectives by type. Options: Company, Team, Personal |
| ID | The specific team or person ID to filter objectives (only applicable when Type is Team or Personal) |
| Performance Cycle ID | Filter objectives by a specific performance cycle ID (e.g., 11561 for Q2 2025). Leave empty to get all cycles |
| Simplify | Whether to return simplified response data or the raw API response (boolean) |
| Sort Direction | Direction to sort the results. Options: Ascending, Descending |
| Sort Field | Field to sort by. Options: ID, Title |
Output
The output is a JSON array containing the retrieved objectives. Each objective includes details such as its ID, title, type, associated performance cycle, and other relevant metadata depending on the API's response structure.
If "Simplify" is enabled, the output will contain a streamlined version of the objectives focusing on key fields for easier consumption. If disabled, the full raw API response is returned, which may include additional nested data and metadata.
No binary data is produced by this operation.
Dependencies
- Requires an active connection to the Flowyteam API using a valid API authentication token configured in n8n credentials.
- The node depends on the Flowyteam API endpoints for OKR objectives.
- Proper permissions are needed on the API side to read objectives data.
Troubleshooting
Common Issues:
- Invalid or missing API credentials will cause authentication errors.
- Providing an invalid or non-existent performance cycle ID or team/person ID may result in empty responses or errors.
- Selecting "Team" or "Personal" type without specifying the corresponding ID will likely yield no results or errors.
- Network connectivity issues can prevent successful API calls.
Error Messages:
- Authentication failures: Check that the API key credential is correctly set up and has necessary permissions.
- Validation errors related to IDs: Verify that the provided team/person or performance cycle IDs exist and are correct.
- Unsupported sort field or direction: Ensure the selected options are valid as per the property definitions.
Links and References
- Flowyteam API Documentation (for detailed API endpoint info)
- OKR Management Best Practices
- n8n Documentation on Creating Custom Nodes