Connect Klaviyo for preorder emails

Connect Klaviyo to send preorder confirmation, shipping update, and payment-failed emails through your own Klaviyo flows instead of STOQ's built-in templates. STOQ fires an event into Klaviyo at each of those moments; you build and send the branded email from a Klaviyo flow. Use this if you want full control over email design, A/B testing, or audience segmentation.

Before you begin

Choose your setup

Once Klaviyo is connected, choose how the Preorder confirmed flow gets built in Klaviyo:

• Automatic setup: STOQ creates the email templates and flows in your Klaviyo account and activates them for you. Use this for the fastest path to a working integration, or if you don't already have preorder flows in Klaviyo.
• Manual setup: you create the flows yourself in Klaviyo, then enter the flow names in STOQ so it can verify them. Use this if you already have flows or want to build from your own templates.

Both methods trigger off the same underlying metric events, listed under Metrics STOQ sends to Klaviyo below.

What customers will see

Customers still get a preorder confirmation email, and a shipping update or payment-failed email if you set those up, at the same trigger points as before. The difference is who sends it: once Klaviyo is selected as the provider, STOQ no longer sends the email itself, it only fires the metric event, and your Klaviyo flow controls the design, subject line, send timing, and unsubscribe handling. Each event includes order and customer details you can use to personalize the flow, for example the customer's name, the order link, and a cancel link. SMS notifications can be routed through Klaviyo the same way, using a separate Send SMS through setting.

Set it up

Connecting Klaviyo has three parts: connect the account, tell STOQ to send preorder emails through it, then set up the flow Klaviyo uses to actually send them.

Connect your Klaviyo account

The connection is made once per shop and applies to both preorder emails and back-in-stock alerts. You can start it from either place:

• Integrations sub-tab: click Preorders in the left menu, click the Settings tab, open the Integrations sub-tab, find the Klaviyo card, and click Set up.
• Preorder email template: click Preorders in the left menu, click the Settings tab, open the Notifications sub-tab, click Customize email on the 'Preorder confirmed' card, open Send emails through, and select Klaviyo.

Once connected, STOQ immediately sends test events to your Klaviyo account for all supported metrics so they appear in Klaviyo's metric library before you build flows.

Select Klaviyo as your preorder email provider

Connecting Klaviyo doesn't automatically route preorder emails through it, you also need to set it as the provider.

Set up the preorder confirmed flow

Set up optional flows (shipping update and payment failed)

After the main flow is working, you can set up two more in the 3. Additional preorder flows (Optional) section of the email provider panel.

Metrics STOQ sends to Klaviyo

Use these as flow triggers in Klaviyo:

Customer signed up for alert (STOQ) fires automatically as soon as a customer registers for an alert, no extra flow or notification setup is required. The back-in-stock and preorder metrics need the corresponding notification enabled and Klaviyo selected as the provider.

Event properties sent with each metric

Each preorder confirmed, shipping update, and payment-failed event includes the following, which you can use to personalize your flow emails:

Configure profile sync and tags

When Klaviyo is connected, visitors who sign up for back-in-stock alerts are synced to your Klaviyo account as profiles. Add a tag to those profiles with the Profile tags field that appears under Settings once Klaviyo is connected. The same tag is shared across Klaviyo, Omnisend, Mailchimp, and Shopify customer syncing.

Auto-subscribe setting

In the Settings section at the bottom of the Klaviyo panel, the Auto-subscribe profiles to marketing checkbox is on by default, subscribing Klaviyo profiles to marketing so your flow emails can be delivered. Uncheck it only if your STOQ Klaviyo emails are configured as Transactional in Klaviyo, which bypasses the subscription requirement.

Disconnect Klaviyo

Open the Integrations sub-tab (Preorders in the left menu, Settings tab, Integrations), click Set up on the Klaviyo card, then click Disconnect in the Klaviyo app section. STOQ revokes the OAuth tokens and disables all Klaviyo-related toggles. If your email provider was set to Klaviyo, it switches back to STOQ automatically and emails start sending through STOQ again.

Check your setup

1. Open the Notifications sub-tab (Preorders in the left menu, Settings tab, Notifications) and confirm the Klaviyo setup incomplete banner isn't showing.
2. Place a test preorder on your store.
3. In your Klaviyo dashboard, go to Analytics → Metrics and confirm the Preorder confirmed (STOQ) metric received an event.
4. Check your inbox for the preorder confirmation email delivered by your Klaviyo flow.

Troubleshooting

Limitations

• If Klaviyo is selected as the provider but the connection or flow isn't fully verified, STOQ blocks the notification rather than falling back to its own email delivery, so nothing sends until setup is complete.
• Preorder confirmed, shipping update, and payment failed each need their own flow verified separately, connecting Klaviyo doesn't automatically enable all three.

FAQ

Related guides