Klaviyo Event Reference

This page documents all event properties sent to Klaviyo by Auction Plus. Use these properties when building Klaviyo flows, segments, and email/SMS templates.

For setup instructions, see the Klaviyo Integration page.

---

Customer Profile

Every event includes the following customer profile data:

Property	Description	Example
email	The customer's email address	[e-mail]
Auction Plus Status	Whether the customer is active or banned	active

---

Auction Events

Bid Placed

Triggered when the high bid for an auction listing is updated.

{
    "shop": {
        "name": "My Store",
        "logo": "https://cdn.shopify.com/s/files/1/example/logo.png"
    },
    "auction": {
        "uid": "34dhchwby12yzfhgk6d6t86e3c",
        "total_bids": 12,
        "ends_at": "2026-03-10T18:00:00+00:00"
    },
    "high_bid": {
        "amount": {
            "display": "$150.00",
            "value": "15000",
            "currency": "USD"
        },
        "automatic": false
    },
    "product": {
        "id": 8045243138239,
        "title": "Vintage Watch",
        "url": "https://my-store.myshopify.com/products/vintage-watch",
        "photo_url": "https://cdn.shopify.com/s/files/1/example/product.png"
    }
}

Property	Description
shop.name	Your shop's display name
shop.logo	URL to your shop logo (null if not set)
auction.uid	Unique auction identifier
auction.total_bids	Total number of bids on the auction
auction.ends_at	Auction end date/time (ISO 8601)
high_bid.amount.display	Formatted display price of the current high bid
high_bid.amount.value	Numeric value of the current high bid (in the smallest currency unit, e.g. cents)
high_bid.amount.currency	Currency code
high_bid.automatic	Whether this bid was placed automatically via proxy bidding
product.id	Shopify product ID
product.title	Auction/product title
product.url	Storefront URL for the product
product.photo_url	URL to the product image (null if not set)

Note: high_bid.automatic is false for the initial bid placed when a customer enters their maximum bid. Subsequent automatic (proxy) bids triggered by other bidders will have high_bid.automatic set to true. Use this property to differentiate between manual and automatic bids in your Klaviyo flows.

Outbid

Triggered when a customer is outbid by another bidder.

{
    "shop": {
        "name": "My Store",
        "logo": null
    },
    "auction": {
        "uid": "34dhchwby12yzfhgk6d6t86e3c",
        "total_bids": 13,
        "ends_at": "2026-03-10T18:00:00+00:00"
    },
    "high_bid": {
        "amount": {
            "display": "$175.00",
            "value": "17500",
            "currency": "USD"
        }
    },
    "product": {
        "id": 8045243138239,
        "title": "Vintage Watch",
        "url": "https://my-store.myshopify.com/products/vintage-watch",
        "photo_url": "https://cdn.shopify.com/s/files/1/example/product.png"
    }
}

Property	Description
shop.name	Your shop's display name
shop.logo	URL to your shop logo (null if not set)
auction.uid	Unique auction identifier
auction.total_bids	Total number of bids on the auction
auction.ends_at	Auction end date/time (ISO 8601)
high_bid.amount.display	Formatted display price of the new high bid
high_bid.amount.value	Numeric value of the new high bid (in the smallest currency unit, e.g. cents)
high_bid.amount.currency	Currency code
product.id	Shopify product ID
product.title	Auction/product title
product.url	Storefront URL for the product
product.photo_url	URL to the product image (null if not set)

Auction Won

Triggered when a customer wins an auction.

{
    "shop": {
        "name": "My Store",
        "logo": null
    },
    "auction": {
        "uid": "34dhchwby12yzfhgk6d6t86e3c",
        "total_bids": 15,
        "ends_at": "2026-03-10T18:00:00+00:00"
    },
    "winner": {
        "amount": {
            "display": "$200.00",
            "value": "20000",
            "currency": "USD"
        }
    },
    "product": {
        "id": 8045243138239,
        "title": "Vintage Watch",
        "url": "https://my-store.myshopify.com/products/vintage-watch",
        "photo_url": "https://cdn.shopify.com/s/files/1/example/product.png"
    },
    "payment_url": "https://my-store.myshopify.com/apps/auction-plus/purchases"
}

Property	Description
shop.name	Your shop's display name
shop.logo	URL to your shop logo (null if not set)
auction.uid	Unique auction identifier
auction.total_bids	Total number of bids on the auction
auction.ends_at	Auction end date/time (ISO 8601)
winner.amount.display	Formatted display price of the winning bid
winner.amount.value	Numeric value of the winning bid (in the smallest currency unit, e.g. cents)
winner.amount.currency	Currency code
product.id	Shopify product ID
product.title	Auction/product title
product.url	Storefront URL for the product
product.photo_url	URL to the product image (null if not set)
payment_url	Direct link to the customer's checkout page

---

Offer Events

All four offer events -- Offer Received, Counteroffer Received, Offer Accepted, and Offer Declined -- share the same properties.

{
    "shop": {
        "name": "My Store",
        "logo": null
    },
    "offer": {
        "uid": "tgyt6dwq3537bbr9xbcw09509c",
        "expires_at": "2026-03-07T19:19:04+00:00",
        "amount": {
            "display": "$95.00",
            "value": "9500",
            "currency": "USD"
        },
        "message": null,
        "is_seller": true
    },
    "product": {
        "id": 8045243138239,
        "photo_url": null
    },
    "variant": {
        "id": 43973168332991,
        "url": "https://my-store.myshopify.com/products/title?variant=43973168332991",
        "display_name": "Offer Test"
    },
    "offers_url": "https://my-store.myshopify.com/apps/auction-plus/offers"
}

Property	Description
shop.name	Your shop's display name
shop.logo	URL to your shop logo (null if not set)
offer.uid	Unique offer identifier
offer.expires_at	Offer expiration date/time (ISO 8601)
offer.amount.display	Formatted display price of the offer
offer.amount.value	Numeric value of the offer (in the smallest currency unit, e.g. cents)
offer.amount.currency	Currency code
offer.message	Message included with the offer (null if none)
offer.is_seller	Whether this offer was made by the seller
product.id	Shopify product ID
product.photo_url	URL to the product image (null if not set)
variant.id	Shopify variant ID
variant.url	Storefront URL for the variant
variant.display_name	Display name of the variant
offers_url	Direct link to the customer's offers page