Set up Klaviyo integration with STOQ for automated back-in-stock alerts. A complete guide covering how to connect STOQ to Klaviyo, set up flows, and customize emails for Shopify merchants.

Overview

STOQ's Klaviyo integration allows you to send branded back in stock email alerts through your existing Klaviyo account. This integration enhances your ability to maintain brand consistency and leverage Klaviyo's advanced email marketing features for customer notifications when products are restocked.

Getting Started with Klaviyo Integration

Setting up the Klaviyo integration for back in stock alerts involves three main steps: connecting our app to klaviyo, creating flows in Klaviyo, and testing your setup.

Prerequisites

Before you begin, ensure you have:

• An active Klaviyo account with email sending capabilities
• Admin access to your STOQ app in Shopify

Navigation to Integration Settings

To access the Klaviyo integration settings:

1. From your Shopify admin, open the STOQ app
2. Navigate to Back in stock alerts from the main menu
3. Click Customize email under the notifications tab.
4. Locate Send emails through section.
5. Select Klaviyo as your email provider
6. Click Connect button which will open a new tab to login to klaviyo to authorize STOQ to access your Klaviyo account.

7. Click "Allow" button to connect your Klaviyo account.

Once the connection is successful, you will be redirected to the Stoq app. After connecting, you need to refresh the email customizer page in Stoq to confirm the installation.

Step 2: Create Flows in Klaviyo

Understanding STOQ Event Types

STOQ sends different event types to Klaviyo depending on the type of notification:

• Stoq - Back In Stock Alert: Initial back in stock notification
• Stoq - Back In Stock Reminder 1: First reminder email (if enabled)
• Stoq - Back In Stock Reminder 2: Second reminder email (if enabled)
• Stoq - Preorder Confirmed: Preorder confirmation emails
• Stoq - Customer signed up for alert: Customer signup events

Creating a Flow for Back in Stock Alerts

1. In your Klaviyo account, navigate to Flows in the left sidebar
2. Click Create Flow in the upper right corner
3. Select Build your own flow type
4. Name your flow exactly as specified in STOQ (e.g., "Stoq - BIS flow" for the main flow)

Note: The flow name must match exactly what you enter in STOQ's flow name field, including capitalization and spacing.

Setting Up the Flow Trigger

1. Click on the Select a trigger button in the empty trigger node
2. In the right sidebar that appears, you'll see several trigger options
3. Under "Your Metrics," select Stoq, then choose Back in Stock Alert (STOQ).

[](https://storage.crisp.chat/users/helpdesk/website/-/f/6/9/b/f69b1402a211d800/image_1b8rhrx.png)

The "Back in stock alert (STOQ)" trigger will be used to send back in stock notifications automatically to customers when you restock an item in Shopify.

Important: This metric should have been automatically created by Stoq during the integration process.

Adding Email Action to Flow

1. Click the + button below your trigger to add an action
2. Select Email from the action options
3. Choose to create a new email template or select an existing one
4. Customize your email template using Klaviyo's editor

Configuring Flow Name in STOQ

1. Return to STOQ's Klaviyo integration settings
2. In the Create a flow section, enter your flow name in the Flow name field

3. Click on Verify flow to confirm STOQ can find your Klaviyo flow

If verification fails, check that:

• Your flow name in STOQ matches exactly with your Klaviyo flow name
• Your flow is published/active in Klaviyo
• The trigger is properly configured with the correct STOQ metric

Step 3: Customize Email Templates

Klaviyo integration allows you to fully customize your back in stock email templates using Klaviyo's powerful email editor.

Available Template Variables

When creating email templates for back in stock alerts in Klaviyo, you can use the following variables to personalize and customize your messages:

Product Information

• {{event.product_title}}: The title of the product for which the back in stock alert was created
• {{event.variant_title}}: The specific variant of the product
• {{event.title_incl_variant}}: The combined title of the product and its variant
• {{event.price}}: The price of the product
• {{event.currency}}: The currency code of the product
• {{event.vendor}}: The name of your Shopify store
• {{event.image_url}}: The URL of the product image
• {{event.checkout_link}}: The direct link to your Shopify store's checkout page
• {{event.product_page_link}}: The link to the product page on your Shopify store
• {{event.unsubscribe_link}}: The unsubscribe link for customers who wish to opt-out of future back in stock alerts

Customer Information

• {{event.customer_name}}: The name of the customer
• {{event.customer_email}}: The email address of the customer
• {{event.customer_locale}}: The locale/language preference of the customer

Shop Information

• {{event.shop_name}}: The name of your Shopify store
• {{event.shop_logo_url}}: The URL of your shop's logo
• {{event.shop_domain}}: Your shop's domain

Using Variables in Templates

To use these variables in your email templates, simply copy and paste the desired variable into your template where you want the corresponding information to appear. When the email is sent, the variables will be automatically replaced with the relevant data.

For example: If you want to display the product title in your email, you would add {{event.product_title}} to your template. When the back in stock alert is triggered, {{event.product_title}} will be replaced with the actual title of the product.

Best Practices for Email Templates

• Include the product image using {{event.image_url}}
• Use clear call-to-action buttons linking to {{event.checkout_link}}
• Personalize with {{event.customer_name}}
• Always include the unsubscribe link {{event.unsubscribe_link}}
• Test your template with sample data before going live

Step 4: Test Your Integration

After setting up your Integration and flows, it's important to test the complete integration to ensure everything works correctly.

Sending Test Events

1. In STOQ's Klaviyo integration settings, click Send test event
2. This will send a dummy event to Klaviyo with sample data
3. Check your Klaviyo account to verify the event was received
4. Verify that your flow triggers correctly with the test event

End-to-End Testing

For complete testing:

1. Sign up for a back in stock alert on your store using your email address
2. Restock the product in your Shopify admin
3. Check your inbox for the back in stock alert email
4. Verify the email content displays correctly with real product data

Advanced Configuration

For merchants with more complex needs, STOQ's Klaviyo integration offers additional configuration options.

Multiple Template Flows

If you use multiple email templates (such as reminder emails), you can create separate flows for each:

• Create individual flows for each template type
• Use specific metric names for each flow trigger
• Configure flow names separately for each template in STOQ

Known Limitations

The Klaviyo integration has certain constraints that merchants should be aware of when planning their email strategy.

• Klaviyo Sending Limits: Your email sending is subject to Klaviyo's account limits and sending policies. High-volume stores may encounter Klaviyo API rate limits during peak restocking periods
• Customer data sync occurs when customers sign up, not retroactively for existing customers.
• Only the variables provided by Stoq can be used in the email template. Custom Klaviyo variables may not be compatible.
• The integration supports only one dedicated flow for back-in-stock alerts. Multiple flows for different product categories are not supported.
• There might be a slight delay between a product coming back in stock and the notification being triggered in Klaviyo.

Troubleshooting

Common issues and their solutions when setting up Klaviyo integration for back in stock alerts.

FAQs

Common questions about STOQ's Klaviyo integration for back in stock alerts.

Can I use my existing Klaviyo email templates?

Yes, you can use existing Klaviyo email templates in your flows. Just make sure to add the STOQ template variables to display product and customer information correctly.

What happens if my Klaviyo account reaches its sending limit?

If your Klaviyo account reaches its sending limit, back in stock emails will not be delivered until your limit resets. Consider upgrading your Klaviyo plan if you frequently hit limits.

Can I send back in stock alerts through both STOQ and Klaviyo?

No, you should choose either STOQ's built-in email system or Klaviyo integration, not both, to avoid sending duplicate emails to customers.

How do I switch back to STOQ's built-in email system?

In your template settings, change the email provider from "Klaviyo" back to "STOQ" and your emails will be sent through STOQ's system instead.

Are preorder confirmation emails supported?

Yes, STOQ sends preorder confirmation events to Klaviyo using the "Stoq - Preorder Confirmed" metric. Create a separate flow for preorder confirmations.

Can I track email performance in Klaviyo?

Yes, all emails sent through the integration will appear in your Klaviyo analytics with full open rates, click rates, and other engagement metrics.

What customer data is synced to Klaviyo?

STOQ syncs customer email, name, phone number (if provided), and locale. Customers are tagged with "restock-rocket" as the source for easy identification.

Do I need separate flows for reminder emails?

Yes, if you use multiple reminder templates, create separate flows for each using the corresponding metric names like "Stoq - Back In Stock Reminder 1" and "Stoq - Back In Stock Reminder 2".

Updated on: 04/08/2025