3. Postflows Event Properties Reference

Every event Postflows sends to Klaviyo or Omnisend includes a set of properties you can use to personalize email content. This article lists all available properties and how to reference them in your email templates.

Before using any property below, always confirm it against the live event data in your email platform's preview tool first. In Klaviyo, that's Preview Email → the "All properties" panel on the right. In Omnisend, it's the event data shown in Preview & test. The tables below are a reference guide, but the live payload in your own account is the source of truth.

How to use properties

In Klaviyo, reference properties directly under event:

{{ event.customer.first_name }}
{{ event.tracking.tracking_number }}
{{ event.order.name }}

In Omnisend, reference properties using double square brackets. Profile data, like the customer's name, is accessed under contact instead of being nested under event:

[[contact.first_name]]
[[event.order.name]]
[[event.tracking.tracking_number]]

Order details

Property	Example value	Description
`order.id`	`5678901234`	Shopify order ID
`order.name`	`#1001`	Order number with hash
`order.total_price`	`79.99`	Order total
`order.currency`	`USD`	Currency code

Customer details

Property	Example value	Description
`customer.email`	`[email protected]`	Customer email address
`customer.first_name`	`Jane`	Customer first name
`customer.last_name`	`Smith`	Customer last name
`customer.phone`	`+15551234567`	Customer phone number

Shipping address

Property	Example value
`shipping_address.first_name`	`Jane`
`shipping_address.last_name`	`Smith`
`shipping_address.address1`	`123 Main St`
`shipping_address.address2`	`Apt 4B`
`shipping_address.city`	`New York`
`shipping_address.province`	`New York`
`shipping_address.province_code`	`NY`
`shipping_address.country`	`United States`
`shipping_address.country_code`	`US`
`shipping_address.zip`	`10001`
`shipping_address.phone`	`+15551234567`
`shipping_address.company`	`Acme Inc`

Billing address

Same structure as shipping address, under billing_address.*.

Line items

Line items is an array. In Klaviyo, iterate using {% for item in event.line_items %}.

Property	Example value	Description
`line_items[].title`	`Classic T-Shirt`	Product name
`line_items[].quantity`	`2`	Quantity ordered
`line_items[].price`	`29.99`	Unit price
`line_items[].sku`	`TSH-BLK-M`	Product SKU
`line_items[].variant_title`	`Black / M`	Variant name
`line_items[].name`	`Classic T-Shirt - Black / M`	Full product + variant name
`line_items[].vendor`	`ACME Apparel`	Product vendor
`line_items[].image_url`	`https://...`	Product image URL
`line_items[].product_id`	`7890123456`	Shopify product ID
`line_items[].variant_id`	`4567890123`	Shopify variant ID

Tracking details

Property	Example value	Description
`tracking.url`	`https://...`	Postflows tracking page URL (or direct carrier URL if no custom tracking page is configured)
`tracking.carrier_link`	`https://...`	Direct carrier tracking URL (e.g. UPS, FedEx website). `null` for `order_created` events
`tracking.tracking_number`	`1Z999AA10123456784`	Carrier tracking number. Not present for `order_created` events
`tracking.carrier`	`ups`	Carrier slug. Not present for `order_created` events
`tracking.estimated_delivery_date`	`2025-11-25T00:00:00Z`	Estimated delivery date (when available). Not present for `order_created` events

Event metadata

Property	Example value	Description
`event.code`	`shipment_delivered`	Internal event code
`event.name`	`4. Shipment Delivered`	Display name
`event.description`	`Package has been delivered`	Short description
`event.note`		Optional note (usually empty)

Tips

Linking to your tracking pagetracking.url is the Postflows tracking page URL. Use it to send customers to their branded tracking experience:

<a href="{{ event.tracking.url }}">Track your package</a>

Linking directly to the carrier Use tracking.carrier_link for a direct link to the carrier's tracking page (UPS, FedEx, etc.):

<a href="{{ event.tracking.carrier_link }}">Track on carrier site</a>

Note: carrier_link is null for order_created events — wrap it in a conditional.

Estimated delivery date tracking.estimated_delivery_date is not always available - depends on carrier. Wrap in a conditional in Klaviyo:

{% if event.tracking.estimated_delivery_date %}
  Estimated delivery: {{ event.tracking.estimated_delivery_date }}
{% endif %}