Klaviyo icon

Klaviyo

Interact with the Klaviyo API

Actions17

Event → Get Many

AI-generated

Overview

This node interacts with the Klaviyo API to retrieve multiple event records. It is useful for scenarios where you need to fetch a list of events with various filtering, sorting, and pagination options. For example, you can use it to monitor user activities, analyze event trends, or integrate event data into workflows.

Use Case Examples

  1. Fetch the latest 50 events sorted by newest timestamp to analyze recent user interactions.
  2. Retrieve events filtered by a specific metric_id or profile_id to segment event data.
  3. Paginate through event data using the page cursor to process large datasets in batches.

Properties

Name Meaning
Page Cursor Cursor for paginating through event pages, allowing retrieval of subsequent pages of event data.
Page Size Number of events to retrieve per page, with a minimum of 1 and a maximum of 200.
Sort Sort order of the events, such as by datetime or timestamp in ascending or descending order.
Filters Filters to apply on the events, including filtering by metric_id or profile_id fields and date-based filters with operators like greater-than or less-than.
Event Fields Specific fields of the event resource to include in the response, such as datetime, event_properties, timestamp, and uuid.
Additional Resources Additional related resources to include in the response, such as metric and profile data associated with the events.
Metric Fields Fields of the metric resource to include when metric is selected in Additional Resources, such as name, created, updated, and integration.
Profile Fields Fields of the profile resource to include when profile is selected in Additional Resources, such as email, phone_number, external_id, and various location and personal details.
Request Options Options to control request behavior such as batching, SSL certificate validation, proxy settings, and timeout duration.

Output

JSON

  • datetime - The datetime of the event.
  • event_properties - Properties associated with the event.
  • timestamp - The timestamp of the event.
  • uuid - The unique identifier of the event.
  • metric - Included metric data if requested.
  • profile - Included profile data if requested.

Dependencies

  • Klaviyo API key credential

Troubleshooting

  • Ensure the API key credential is correctly configured and has the necessary permissions to access event data.
  • Verify that the page cursor and page size values are valid to avoid pagination errors.
  • Check filter syntax and values to ensure they conform to expected formats, especially date filters.
  • If SSL issues occur, consider enabling the option to ignore SSL certificate validation, but be aware of security risks.
  • Timeout errors can be mitigated by increasing the timeout setting in request options.

Links

Discussion