Articles on: Timesact V2

Notifications - Klaviyo

Route Timesact events into Klaviyo so your existing flows, templates, and segments do the sending. For how this compares to the other channels, see Notifications Overview.


Connect Klaviyo


  1. In the app, open Billing & Account from the main sidebar.
  2. Click the Integrations tab.
  3. On the Klaviyo card, click Connect.
  4. You are redirected to Klaviyo's sign-in screen. Sign in, or pick the account if you have several.
  5. Review the requested permissions and approve.
  6. You return to the Timesact admin and the card shows Connected with the date.


To disconnect, click Disconnect on the same card. Events already in Klaviyo are unaffected, new events just stop firing. One Klaviyo account per shop, to switch accounts, disconnect then reconnect.


Permissions Timesact requests


  • accounts:read — required by Klaviyo on every install.
  • events:write — send Timesact events into your Klaviyo metrics.
  • metrics:read — check our metrics exist (used by the admin status display).
  • profiles:write — create or update customer profiles when sending events and subscribing newsletter sign-ups.
  • subscriptions:write — record marketing consent when a customer ticks the newsletter checkbox.


Timesact does not access your subscriber lists, campaign performance, or billing.


Turning it on


In the customer experience template's Notifications, set the functionality's channel to Klaviyo and Save. The Available events panel shows what that functionality sends.


Events Timesact sends


  • Timesact - Back in Stock Subscribed — shopper signs up via Notify Me.
  • Timesact - Back in Stock Ready — subscribed variant restocked (once per subscriber).
  • Timesact - Preorder Confirmed — customer places an order with a pre-order item (once per order).


Each becomes a Klaviyo Metric (tagged source timesact). Use them as flow triggers and reference event properties as {{ event.property_name }}.


Event properties


Copy the value from the first column straight into your Klaviyo template.


Timesact - Back in Stock Subscribed and Timesact - Back in Stock Ready share the same properties:


Copy this into your template

What it contains

Available on

{{ event.customer_email }}

The shopper's email address

Both

{{ event.customer_name }}

The shopper's name (empty for now)

Both

{{ event.product_id }}

The product's Shopify ID

Both

{{ event.variant_id }}

The variant's Shopify ID

Both

{{ event.product_title }}

The product's title

Both

{{ event.variant_title }}

The chosen variant, for example size or colour

Both

{{ event.product_handle }}

The product's URL handle

Both

{{ event.product_image_url }}

Link to the product image

Both

{{ event.product_url }}

Link to the product page

Both

{{ event.price }}

The variant price

Both

{{ event.inventory_quantity }}

Current inventory for the variant

Both

{{ event.shop_name }}

Your store's name

Both

{{ event.shop_domain }}

Your store's domain

Both

{{ event.subscribe_to_newsletter }}

Whether the shopper ticked the newsletter box

Subscribed only


Timesact - Preorder Confirmed has its own set:


Copy this into your template

What it contains

{{ event.customer_email }}

The customer's email address

{{ event.customer_name }}

The customer's name

{{ event.order_id }}

The order's Shopify ID

{{ event.order_number }}

The order number, for example #1234

{{ event.order_total }}

The order total

{{ event.order_currency }}

The order's currency

{{ event.product_count }}

Number of pre-order items in the order

{{ event.shop_name }}

Your store's name

{{ event.shop_domain }}

Your store's domain

{{ event.preorder_products }}

An array of the pre-order items, loop it in your template (see below)


The preorder_products array holds one entry per pre-order item. Loop it in your template and reference each item's fields:


{% for item in event.preorder_products %}
{{item.product\_title}} - {{item.variant\_title}} x{{item.quantity}}
{% endfor %}


Each item exposes: product_id, variant_id, product_title, variant_title, price, quantity, and preorder_information.


How to use the events in Klaviyo


The events above arrive in Klaviyo as Metrics. You act on them inside Klaviyo by building a new flow, or editing a flow you already use:


  1. In Klaviyo, go to Flows and either Create flow or open an existing flow you want this to drive.
  2. Set the flow trigger to Metric, then select the Timesact metric (for example Timesact - Back in Stock Ready, Timesact - Back in Stock Subscribed, or Timesact - Preorder Confirmed).
  3. Add an Email (or SMS) action and select or build the template you want to send.
  4. Personalize it with the event's data, referenced as {{ event.property_name }}, for example {{ event.product_title }} or {{ event.product_url }}.
  5. Add any filters or conditional splits you need, then turn the flow live.


If you already run Klaviyo, there is nothing extra to install, just point a flow's trigger at the Timesact metric, or add it onto an existing flow. Keep in mind a metric-triggered flow runs every time the event fires, so a subscriber re-enters it on each qualifying restock.


Already running post-purchase flows?


If you already have Klaviyo flows running off your Shopify orders and you just need to tell a pre-order apart from a normal order, use the Timesact - Preorder Confirmed metric for that. It is a common instinct to reach for the Pre-order tag Timesact adds to the Shopify order instead, but those tags are the right tool inside Shopify, for filtering your Orders list, saved views, Shopify Flow and exports. Inside Klaviyo the event is the reliable route, because it arrives carrying the order number, the totals and the full list of what was pre-ordered.


Two ways to use it, once the Klaviyo channel is set on the functionality as above:


  • Give pre-orders their own flow, triggered on the Timesact - Preorder Confirmed metric.
  • Keep the flow you have and add a conditional split on Timesact - Preorder Confirmed, so pre-order buyers take a different branch and in-stock buyers carry on as usual.


Nothing extra needs installing on the Klaviyo side, and your existing templates, segments and sending settings keep working as they do now.


Testing and troubleshooting


Trigger the event on a test shop, then check Klaviyo → Analytics → Metrics → the metric's Activity Feed (it appears within about a minute, and the first fire can take a moment to create the metric). If events stop, the usual cause is a disconnected integration, reconnect from Billing & Account → Integrations. Properties are snake_case.

Updated on: 08/11/2026

Was this article helpful?

Share your feedback

Cancel

Thank you!