> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.hoppyapps.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 🔗 Integrate PopUps App with Shopify Flow

Connecting Hoppy PopUps with **Shopify Flow** lets you trigger automations every time a visitor submits a popup form. Because the app exposes a native Flow trigger, you can build workflows that react instantly to popup submissions — no coding required.

Use this integration to send internal notifications, tag customers, create draft orders, start email sequences, or connect with other apps that support Flow.

---

# **⚠️ Before You Begin**

Before setting up this integration, make sure:

* The **Hoppy PopUps** app is installed on your Shopify store  
* **Shopify Flow** is available on your Shopify plan (Flow comes free on Shopify, Advanced, and Plus plans)

No API keys or credentials are needed — the trigger is built into the app and appears automatically inside Flow.

---

# **🛠️ Step 1 — Open Shopify Flow**

From your Shopify Admin:

→ Go to **Apps → Shopify Flow**

---

# **➕ Step 2 — Create a New Workflow**

Inside Shopify Flow:

→ Click **Create workflow**

You'll see the workflow builder with a **Trigger** block.

---

# **🎯 Step 3 — Select the PopUp Trigger**

In the workflow:

→ Click on **Select a trigger**  
→ Search for **Hoppy PopUps**

→ Select the trigger named **📩 Popup Form Submitted**

This trigger fires automatically every time any popup on your store receives a form submission.

---

# **📋 Step 4 — Understand the Available Data**

When the trigger fires, Shopify Flow receives the following data fields you can use in your workflow:

| Field | Type | Description |
| ----- | ----- | ----- |
| **Popup ID** | Text | The unique ID of the popup that was submitted |
| **Customer** | Customer Reference | A link to the Shopify Customer record (if one exists or was created) |
| **Customer ID** | Text | The Shopify Customer GID string |
| **Page URL** | Text | The page where the visitor submitted the popup |
| **Customer Email** | Text | The email address entered in the popup |
| **Customer Phone** | Text | The phone number entered in the popup (if provided) |

You can use these fields as conditions or pass them into actions later in the workflow.

---

# **⚙️ Step 5 — Add Conditions (Optional)**

If you want the workflow to run only for specific popups or submissions:

→ Click **Add condition** below the trigger

Example conditions:

* **Popup ID equals** `your-popup-id` — Run only for a specific campaign  
* **Customer Email is not empty** — Skip incomplete submissions  
* **Page URL contains** `/products/` — Only react to product-page submissions

---

# **🔧 Step 6 — Add Actions**

After the trigger (and any conditions), add the actions you want Flow to perform.

Popular actions include:

* **Send internal email via Messaging App** — Notify your team when a high-value popup is submitted  
* **Add customer tags** — Tag subscribers for segmentation  
* **Create a draft order** — If your popup includes a special offer  
* **Start a Klaviyo email flow** — Via Klaviyo's Flow connector  
* **Update customer note** — Log the popup source or page URL

---

# **✅ Step 7 — Turn On the Workflow**

Once your workflow is built:

→ Click **Turn on workflow**

The workflow is now live. Every popup submission will automatically trigger the logic you configured.

---

# **🧪 Step 8 — Test the Integration**

To verify the workflow fires correctly:

→ Open your storefront in an **Incognito or Private** browser window  
→ Trigger a popup and submit a test email

Example:

`testflow@example.com`

Then:

→ Return to **Shopify Flow**  
→ Open your workflow  
→ Click the **Activity** tab  
→ Verify that a run was logged with the correct popup data

---

# **⚠️ Common Troubleshooting**

## **Workflow Not Running**

If submissions happen but the workflow doesn't execute:

→ Verify the workflow is **turned on** in Flow  
→ Verify the popup is **published** and active  
→ Check that any conditions you added are actually being met  
→ Remember that Flow runs server-side — there may be a short delay of a few seconds

## **Missing Customer Data**

If the Customer field is empty in Flow:

→ The visitor may have submitted as a guest without an existing Shopify account  
→ Enable the **Shopify Customer List Integration** in Hoppy PopUps to auto-create customers on submission

---

# **🎉 Final Result**

Once configured successfully:

✅ Every popup submission triggers a Shopify Flow workflow automatically  
✅ You can segment, tag, notify, or act on submissions without code  
✅ Popup data (email, phone, page URL, popup ID) flows directly into Flow  
✅ Workflows can be as simple or complex as your business needs 🔗

---