> For the complete documentation index, see [llms.txt](https://docs.auctionplusapp.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.auctionplusapp.com/integrations/klaviyo-events.md).

# 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](/integrations/klaviyo.md) page.

***

## Customer Profile

Every event includes the following customer profile data:

| Property              | Description                              | Example            |
| --------------------- | ---------------------------------------- | ------------------ |
| `email`               | The customer's email address             | `jane@example.com` |
| `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.

```json
{
    "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.

```json
{
    "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.

```json
{
    "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.

```json
{
    "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                              |