Actions16
- User Actions
- Activity Actions
- Message Actions
Overview
This node interacts with the CoachTrigger API to update a user's current KPI (Key Performance Indicator) value within a company context. It is useful for scenarios where you want to programmatically track and update performance metrics of users, such as sales targets, productivity measures, or other custom KPIs relevant to your organization.
Practical examples include:
- Automatically updating a salesperson's monthly sales figures after a transaction.
- Adjusting an employee's performance score based on recent activities.
- Feeding real-time KPI data into dashboards or reporting tools.
Properties
Name | Meaning |
---|---|
Authentication | Choose between "Company Api" or "System Api" authentication methods. |
User ID | The unique identifier of the user whose KPI value you want to update. |
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 CoachTrigger 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.
No binary data output is involved in this operation.
Dependencies
- Requires access to the CoachTrigger API.
- Requires either a "Company Api" or "System Api" authentication credential configured in n8n.
- Network connectivity to
https://www.coachtriggerapp.com/crmApi/update-current-kpi-value
endpoint (inferred from similar endpoints; actual URL used ishttps://www.coachtriggerapp.com/crmApi/get-current-kpi-value
for getting KPI, but update uses a similar pattern).
Troubleshooting
- Authentication errors: Ensure that the correct API key or system key is provided and valid.
- Missing required fields: The node requires
User ID
,KPI ID
, andKPI Value
. Omitting any will cause errors. - Invalid KPI ID or User ID: If these identifiers do not exist in the CoachTrigger system, the API may return errors or no updates will occur.
- Date format issues: If providing
KPI Date
, ensure it matches the expected format by the API (usually ISO 8601). - API connectivity issues: Verify network access to the CoachTrigger API endpoints.
Links and References
- CoachTrigger API Documentation (Assumed link, please verify with actual documentation)
- n8n Documentation on Creating Custom Nodes