Actions12
Activity → Company
AI-generatedOverview
This node interacts with a Coach Trigger development server API to manage and update user activity data, specifically focusing on Key Performance Indicators (KPIs) within a company context. The "Company: Update user current KPI value" operation allows updating the current KPI value for a specific user, which is useful for tracking performance metrics dynamically.
Common scenarios where this node is beneficial include:
- Updating employee performance metrics in real-time based on new data inputs.
- Integrating KPI updates into automated workflows for performance management systems.
- Synchronizing KPI values from external sources or manual inputs into a centralized coaching platform.
For example, a manager could use this node to update an employee's sales KPI after closing a deal, ensuring that performance dashboards reflect the latest data.
Properties
| Name | Meaning |
|---|---|
| Authentication | Choose between "Company Api" or "System Api" for authenticating requests to the API. |
| User ID | The unique identifier of the user whose KPI value is being updated. |
| KPI ID | The identifier of the specific KPI to update for the user. |
| KPI Value | The new value to set for the specified KPI. |
| KPI Date | (Optional) The date associated with the KPI value update, allowing historical tracking. |
Output
The node outputs JSON data representing the response from the API after attempting to update the user's current KPI value. This typically includes confirmation of the update or details about the updated KPI record.
The output structure is:
{
"json": {
// API response object confirming the KPI update or providing updated KPI details
}
}
No binary data output is involved in this operation.
Dependencies
- Requires access to the Coach Trigger development server API at
https://dev.mymatrixapp.com/crmApi. - Requires either a "Company Api" or "System Api" authentication credential configured in n8n to authorize API requests.
- Network connectivity to the API endpoint must be available.
Troubleshooting
- Authentication Errors: If the node returns errors related to authentication, verify that the correct API key or system key is provided and that it has sufficient permissions.
- Invalid User or KPI IDs: Ensure that the User ID and KPI ID are valid and exist in the system; otherwise, the API may return errors or fail silently.
- Date Format Issues: If specifying a KPI Date, ensure it is in the expected format accepted by the API to avoid rejection.
- API Endpoint Unreachable: Network issues or incorrect API URLs can cause request failures; confirm connectivity and endpoint correctness.
- Unexpected Response Format: If the API response cannot be parsed as JSON, check for API changes or errors returned as plain text.
Links and References
- Coach Trigger API Documentation (Assumed URL for reference, replace with actual if available)