Actions16
- User Actions
- Activity Actions
- Message Actions
Overview
This node interacts with the CoachTrigger API to retrieve or update activity-related data for users within a company context. Specifically, the "Company: Get Current KPI value" operation fetches the current Key Performance Indicator (KPI) value for a given user and activity on a specified date. This is useful in scenarios where companies want to monitor employee performance metrics or track progress against specific activities.
Practical examples include:
- Retrieving the latest sales KPI for a salesperson on a particular day.
- Fetching productivity KPIs related to a specific project activity.
- Monitoring daily or periodic performance indicators for coaching or HR purposes.
Properties
| Name | Meaning |
|---|---|
| Authentication | Choose between two authentication methods: "Company Api" (using an API key credential) or "System Api" (using a system key credential). |
| User ID | The unique identifier of the user whose KPI data is being requested. |
| Activity Date | (Optional) The date for which the current KPI data is requested. |
| Activity ID | (Optional) The specific activity identifier for which the KPI value is requested. |
Output
The output JSON contains the response from the CoachTrigger API endpoint that provides the current KPI value for the specified user and activity. The structure depends on the API response but typically includes fields representing KPI metrics such as values, timestamps, and possibly metadata about the activity or user.
No binary data output is involved in this operation.
Dependencies
- Requires access to the CoachTrigger API.
- Requires either a Company API key credential or a System API key credential configured in n8n.
- Network connectivity to
https://www.coachtriggerapp.com/crmApi/get-current-kpi-value.
Troubleshooting
- Missing or invalid credentials: Ensure that the API key or system key is correctly set up in n8n credentials and has the necessary permissions.
- Invalid User ID or Activity ID: Verify that the provided user and activity identifiers exist in the CoachTrigger system.
- Empty or malformed response: Check if the API endpoint is reachable and returning valid JSON. Network issues or API downtime could cause failures.
- Date format issues: If specifying an activity date, ensure it matches the expected format by the API (usually ISO 8601 or similar).
Links and References
- CoachTrigger API Documentation (assumed URL for reference)
- n8n documentation on HTTP Request Node for understanding API calls in workflows