Flowyteam icon

Flowyteam

Custom node for Flowyteam API
Join our community

Actions101

Overview

The node provides integration with the Flowyteam API to manage OKR (Objectives and Key Results) objectives. Specifically, for the Create operation on the OKR Objective resource, it allows users to create a new objective within their organization's OKR framework.

This node is beneficial in scenarios where teams or organizations want to automate the creation of strategic objectives as part of their performance management or goal-setting workflows. For example, after defining quarterly goals in a planning tool, this node can be used to programmatically add those objectives into Flowyteam's OKR system, ensuring alignment and tracking without manual data entry.

Practical examples include:

  • Automatically creating company-wide objectives at the start of a new quarter.
  • Adding team-specific objectives triggered by project milestones.
  • Integrating with other HR or project management tools to sync objectives.

Properties

Name Meaning
ID The unique identifier for the objective (optional).
Objective Title The title or name of the objective.
Weight The weight or importance of the objective, e.g., "60".
Start Date The start date of the objective in MM/DD/YYYY format, e.g., "01/01/2025".
End Date The end date of the objective in MM/DD/YYYY format, e.g., "03/31/2025".
Additional Fields A collection of optional fields to further define the objective:
- Confidence Confidence level for the objective; options are Low (1), Medium (2), High (3).
- Current Cycle The current cycle ID associated with the objective.
- Description A textual description providing more details about the objective.
- Employee Access List of employee IDs who have access to view or edit this objective.
- Key Result Parent ID The parent key result ID if this objective is linked to a key result.
- Leader Model ID Identifier for the leader model associated with the objective.
- Objective Remarks Additional remarks or notes related to the objective.
- Type The type/category of the objective, defaulting to "company".
- View Options Visibility settings for the objective; options are Everyone, Team Only, Private.

Output

The node outputs JSON data representing the created objective as returned by the Flowyteam API. This typically includes all properties of the newly created objective such as its ID, title, dates, weight, confidence, description, access permissions, and any other metadata.

No binary data output is involved in this operation.

Dependencies

  • Requires an active connection to the Flowyteam API.
  • Needs an API authentication token or API key credential configured in n8n to authorize requests.
  • The node depends on the Flowyteam API endpoints for creating OKR objectives.

Troubleshooting

  • Common Issues:

    • Invalid date formats for start or end dates may cause API errors. Ensure dates are in MM/DD/YYYY format.
    • Missing required fields like Objective Title, Weight, Start Date, or End Date will result in validation errors.
    • Insufficient permissions or invalid API credentials will cause authentication failures.
    • Providing invalid employee IDs in Employee Access may lead to partial failures or errors.

  • Error Messages:

    • "The operation 'create' is not supported for Objective resource" — indicates a misconfiguration or unsupported operation selected.
    • "Invalid date format" — ensure dates follow the specified MM/DD/YYYY format.
    • "Authentication failed" — verify that the API key or token is correctly set up in n8n credentials.
    • "Missing required parameter" — check that all mandatory fields are provided.

Resolving these usually involves verifying input parameters, checking API credentials, and confirming API endpoint availability.

Links and References

Discussion