Documentation Index
Fetch the complete documentation index at: https://docs.subtotal.com/llms.txt
Use this file to discover all available pages before exploring further.
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.
| Key | Type | Description |
|---|
purchase_id | string | Identifier for the purchase |
retailer | string | Identifier for the retailer where the purchase was made |
date | string | The date of the purchase (ISO 8601) |
item_count | string | The number of items in the purchase |
subtotal | number | The subtotal of the purchase |
tax | number | The sales tax that was paid |
total | number | The grand total paid by the customer |
brands | string | The brands associated with each item in the purchase |
upcs | string | The UPCs associated with each item in the purchase |
{
"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.
| Key | Type | Description |
|---|
connection_id | string | Identifier for the connection |
retailer | string | Identifier for the retailer |
{
"connection_id": "01KFRSK9J11G807TAY0GCYSW67",
"retailer": "walmart"
}
Disconnected an Account
Sent when a customer disconnects a retailer account.
| Key | Type | Description |
|---|
connection_id | string | Identifier for the connection |
retailer | string | Identifier for the retailer |
link_url | string | The Link URL that can be used to reconnect the account |
{
"connection_id": "01KFRSK9J11G807TAY0GCYSW67",
"retailer": "walmart",
"link_url": "https://link.subtotal.com/zSG5nWHy?connection_id=01KFRSK9J11G807TAY0GCYSW67"
}
Reauthenticated Connection
Sent when an unauthenticated connection becomes reauthenticated.
| Key | Type | Description |
|---|
connection_id | string | Identifier for the connection |
retailer | string | Identifier for the retailer |
{
"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).
| Key | Type | Description |
|---|
connection_id | string | Unique identifier for the connection |
retailer | string | Identifier for the retailer |
link_url | string | The Link URL that can be used to reconnect the account |
{
"connection_id": "01KFRSK9J11G807TAY0GCYSW67",
"retailer": "walmart",
"link_url": "https://link.subtotal.com/zSG5nWHy?connection_id=01KFRSK9J11G807TAY0GCYSW67"
}
