What’s Changing in Klaviyo API Revision (2025-10-15)

Need help with something?

Talk to data expert

Below is a summary of the key changes that apply to attributed events and flow messages.

1. Changes in Attributed Event Tables

All event tables with attribution data will be affected. Here is the list of tables affected in Daton:

  • all_events
  • active_on_site
  • subscribed_to_email
  • bounced_email
  • updated_email_preferences
  • unsubscribed
  • clicked_email_to_unsubscribe
  • placed_order
  • refunded_order
  • cancelled_order
  • merged_profile
  • subscribed_to_back_in_stock
  • subscribed_to_list
  • unsubscribed_from_list
  • unsubscribed_from_sms

1.1 Attribution Message

Field

Old API Location

New API Location

Campaign/Flow Message Identifier

event_properties → attribution → message (combined value)

Split into two separate identifiers:
relationships → campaign → data → id
relationships → flowmessage → data → id


1.2 Attribution Flow

Field

Old API Location

New API Location

Flow ID

event_properties → attribution → flow

relationships → flow → data → id


1.3 Attributed Event ID

Field

Old API Location

New API Location

attributed_event_id

event_properties → attribution → flow

relationships → attributedevent → data → id

Note: In the old version this field reused the “flow” identifier; in the new version, it is properly split and exposed as its own relationship.


1.4 Attribution Cohort Send

Field

Old API Location

New API Location

Cohort Send Timestamp (send_ts)

event_properties → attribution → send_ts

Not directly available in new API. To derive it:
1. Use relationships → attributedevent → data → id
2. Look up the corresponding record in the Engagement Metric events (e.g., opened email, clicked email, clicked SMS)
3. Get attributes → event_properties → _cohortmessage_send_cohort


2. Flow Message Changes

2.1 Flow Message Name

Field

Old API Location

New API Location

Flow Message Name

attributes → name

attributes → definition → name