Skip to main content
Each event can be used to create segments or trigger flows in Klaviyo.

​
Purchased at Retailer

Sent for each historical purchase and for any newly detected purchases.
KeyTypeDescription
purchase_idstringIdentifier for the purchase
retailerstringIdentifier for the retailer where the purchase was made
datestringThe date of the purchase (ISO 8601)
item_countstringThe number of items in the purchase
subtotalnumberThe subtotal of the purchase
taxnumberThe sales tax that was paid
totalnumberThe grand total paid by the customer
brandsstringThe brands associated with each item in the purchase
upcsstringThe UPCs associated with each item in the purchase
Example 
{
  "purchase_id": "01KEVN1ZPM9H19JSHGN5NF0M69",
  "retailer": "walmart",
  "date": "2025-05-31T14:48:23Z",
  "item_count": 15,
  "subtotal": 43.04,
  "tax": 1.6,
  "total": 44.64,
  "brands": ["frenchs", "heinz", "spam", "jif", "yogi-tea", "cheerios", "m&ms", "goya", "coca-cola"],
  "upcs": ["040000476528", "016000124790", "041331027878", "041331027878", "041331027878", "041331027878", "013000001243", "049000031171", "049000040869", "049000040869", "076950450363", "037600138727", "049000067231", "041500007007", "051500255162"]
}

​
Connected an Account

Sent when a customer connects a retailer account.
KeyTypeDescription
connection_idstringIdentifier for the connection
retailerstringIdentifier for the retailer
Example 
{
  "connection_id": "01KFRSK9J11G807TAY0GCYSW67",
  "retailer": "walmart"
}

​
Disconnected an Account

Sent when a customer disconnects a retailer account.
KeyTypeDescription
connection_idstringIdentifier for the connection
retailerstringIdentifier for the retailer
link_urlstringThe Link URL that can be used to reconnect the account
Example 
{
  "connection_id": "01KFRSK9J11G807TAY0GCYSW67",
  "retailer": "walmart",
  "link_url": "https://link.subtotal.com/zSG5nWHy?connection_id=01KFRSK9J11G807TAY0GCYSW67"
}

​
Reauthenticated Connection

Sent when an unauthenticated connection becomes reauthenticated.
KeyTypeDescription
connection_idstringIdentifier for the connection
retailerstringIdentifier for the retailer
Example 
{
  "connection_id": "01KFRSK9J11G807TAY0GCYSW67",
  "retailer": "walmart"
}

​
Unauthenticated Connection

Sent when an active connection becomes unauthenticated and requires the customer to reauthenticate (e.g. after a retailer password change).
KeyTypeDescription
connection_idstringUnique identifier for the connection
retailerstringIdentifier for the retailer
link_urlstringThe Link URL that can be used to reconnect the account
Example 
{
  "connection_id": "01KFRSK9J11G807TAY0GCYSW67",
  "retailer": "walmart",
  "link_url": "https://link.subtotal.com/zSG5nWHy?connection_id=01KFRSK9J11G807TAY0GCYSW67"
}