RFCALENDAR: Get Events

Retrieve calendar events from RFCALENDAR

Overview

This node retrieves calendar events from the RFCALENDAR service based on a specified date range and filters. It is useful for workflows that need to fetch event data dynamically, such as syncing calendars, generating reports, or triggering actions based on upcoming events.

Common scenarios include:

  • Fetching all events for today, this week, or custom date ranges.
  • Expanding recurring events into individual instances.
  • Limiting the number of returned events to optimize performance.
  • Using either a stored API key credential or a custom API key for multi-calendar access.

For example, you could use this node to get all events happening in the next 7 days and then send reminders or create summaries.

Properties

Name Meaning
Operation Mode Choose whether to use the API key from the saved credential or provide a custom API key.
Custom API Key A custom API key string used when "Use Custom API Key" mode is selected.
Return All Data Whether to return the full response data from the API or just the main list of events.
Time Range The time period for which to retrieve events. Options: Custom Range, Today, This Week, This Month, Next 7 Days, Next 30 Days.
Time Min Start datetime of the custom time range (required if "Custom Range" is selected).
Time Max End datetime of the custom time range (required if "Custom Range" is selected).
Include Recurring Instances Whether to expand recurring events into individual event instances.
Limit Maximum number of events to return (integer).

Output

The node outputs an array of JSON objects where each item contains:

  • json: An array of event objects retrieved from the RFCALENDAR API.
    • If "Return All Data" is enabled, the entire API response is returned.
    • Otherwise, only the main list of events (items field) is returned.

Each event object typically includes details such as event start/end times, title, description, recurrence info (if expanded), and other metadata as provided by the RFCALENDAR API.

No binary data output is produced by this node.

Dependencies

  • Requires an API key credential for RFCALENDAR or a custom API key string.
  • The node makes HTTP GET requests to the RFCALENDAR API endpoint /api/events.
  • The base URL for the API is obtained from the credentials.
  • Proper network connectivity and valid authentication are necessary.

Troubleshooting

  • Invalid API Key or Authentication Errors: Ensure the API key (credential or custom) is correct and has sufficient permissions.
  • Empty Event List: Check the selected time range and ensure there are events within that period.
  • Date Range Errors: When using "Custom Range," both start (Time Min) and end (Time Max) dates must be provided and valid.
  • Limit Not Respected: The API may have its own maximum limits; verify the Limit property does not exceed those.
  • Recurring Events Not Expanded: Confirm that "Include Recurring Instances" is enabled if individual occurrences are needed.
  • Network Issues: Verify connectivity to the RFCALENDAR API endpoint and that the base URL is correctly configured in credentials.

If the node throws errors, enabling "Continue On Fail" can help isolate problematic items without stopping the entire workflow.

Links and References

Discussion