Overview
This node integrates with the Kaizen app to retrieve multiple calendar events based on specified filters and limits. It is useful for automating workflows that require fetching event data from a user's Kaizen calendar, such as syncing events with other calendars, generating reports, or triggering actions based on upcoming events.
For example, you can use this node to:
- Retrieve all events within a specific date range.
- Fetch events tagged with a particular label or color.
- Limit the number of returned events for performance or pagination purposes.
Properties
| Name | Meaning |
|---|---|
| Return All | Whether to return all matching events or limit the number of results. |
| Limit | Maximum number of events to return if "Return All" is false. |
| Filters | Collection of filters to narrow down the events: |
| - After | Only include events starting after this date/time (ISO 8601 format). |
| - Before | Only include events ending before this date/time (ISO 8601 format). |
| - Color Tag | Filter events by their assigned color tag. |
| - IDs | Comma-separated list of specific event IDs to retrieve. |
| - Location | Filter events by location string. |
| - Priority | Filter events by priority number. |
| - Tag | Filter events by tag string. |
Output
The node outputs an array of JSON objects representing the retrieved events. Each event object typically includes fields such as:
id: Unique identifier of the event.title: Title of the event.startTime: ISO 8601 formatted start time.endTime: ISO 8601 formatted end time.isAllDay: Boolean indicating if the event lasts all day.colorTag: Color tag associated with the event.location: Location string.notes: Additional notes about the event.priority: Numeric priority level.reminder: Reminder time in ISO 8601 format.tags: Array of tags associated with the event.
No binary data output is produced by this operation.
Dependencies
- Requires an API key credential for authenticating with the Kaizen API.
- The node makes HTTP requests to the Kaizen cloud functions endpoint at
https://us-central1-kaizen-a1281.cloudfunctions.net/api. - The node uses the Luxon library internally for date-time parsing and formatting.
- Proper timezone configuration is used to convert input dates to ISO strings.
Troubleshooting
- Empty Results: If no events are returned, verify that your filter criteria (dates, tags, IDs) match existing events in your Kaizen account.
- Invalid Date Format: Ensure date/time inputs for filters like "After" and "Before" are valid ISO 8601 strings or compatible with the node's date picker.
- Authentication Errors: Confirm that the API key credential is correctly configured and has necessary permissions.
- Limit Ignored: If you expect limited results but get more, check that "Return All" is set to false and the "Limit" value is properly set.
- API Request Failures: Network issues or API downtime may cause errors; retry later or check Kaizen service status.
Links and References
- Kaizen App Official Website (example placeholder)
- Luxon Date-Time Library
- n8n Documentation on Creating Nodes