> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://stoqapp.crisp.help/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).

# Add customer profiles from STOQ to any Klaviyo list

When customers sign up for back-in-stock or preorder alerts through STOQ, their profiles are synced to Klaviyo. By default, these profiles are not added to a specific Klaviyo list. This guide shows you how to create a Klaviyo flow that automatically adds customer profiles from STOQ to any Klaviyo list of your choice. Once set up, every new STOQ subscriber lands in the right list without any manual work.

### Before You Begin
Make sure you have the following in place before you start: list/segmentave not created one yet, follow the steps below.

### How to Create a Segment for STOQ Profiles

1. In your Klaviyo dashboard, go to **Audience** > **Lists & Segments**.
2. Click **Create list/segment and choose Segment**.
3. Name the segment (for example, "STOQ Back in Stock Subscribers").
4. Add a condition: **Properties about someone** > **source** > **equals** > enter your STOQ profile tag value (the default is `restock-rocket`).
5. Click **Create segment**.

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

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

| **Tip:** The `source` property is set by STOQ when it syncs a customer profile. If you changed the default profile tag in STOQ's integration settings, use that custom value instead of `restock-rocket`.

### How to Create a Flow That Adds Profiles to a Klaviyo List

This section walks you through building a Klaviyo flow that automatically adds customer profiles from STOQ to any Klaviyo list whenever a new profile enters your STOQ segment.

###### Step 1: Create a New Flow

1. In your Klaviyo dashboard, click **Flows** in the left-hand menu.
2. Click **Create flow** in the top-right corner.
3. Select **Build your own** (also in the top-right corner).
4. Give your flow a name (for example, "Add STOQ Profiles to List").
5. Click **Create flow**.

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

###### Step 2: Set Up the Trigger

1. In the flow editor, click **All triggers** on the right-hand side panel.
2. Choose **Added to segment** as the trigger type.
3. Select the STOQ segment you created earlier (for example, "STOQ Back in Stock Subscribers").
4. Click **Save** to confirm the trigger.

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

###### Step 3: Add a Profile Filter (Optional)

If you only want to add profiles that have opted in to marketing, add a filter:

1. In the trigger settings, click **Add profile filter**.
2. Set the condition to **Properties about someone**.
3. Choose the property **StoqAcceptsMarketing** and set the value to **is true**.
4. Click **Save**.

||| **Note:** Skipping this step adds all STOQ profiles to the list, regardless of their marketing consent status. This is fine if you are using the list for internal tracking rather than email campaigns.

###### Step 4: Add the List Update Action

1. In the left-hand panel, find the **List update** action block.
2. Drag it onto the flow canvas and connect it to your trigger.
3. Click the **List update** block to open its settings on the right.
4. Select **Add to a list**.
5. Choose the Klaviyo list you want new STOQ profiles to be added to.
6. Click **Save**.

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

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

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

###### Step 5: Activate the Flow

1. In the top-right corner of the flow editor, change the flow status to **Live**.
2. Confirm when prompted.

From this point on, any new profile that enters your STOQ segment is automatically added to the Klaviyo list you selected.

![](https://storage.crisp.chat/users/helpdesk/website/-/f/6/9/b/f69b1402a211d800/10_1qqh2qf.png)
### Adding Past Profiles to the List

If you already have STOQ profiles in Klaviyo from before you created this flow, you can backfill them.

1. Open the flow you just created.
2. Click **Manage flow** in the top-right corner.
3. Select **Add past profiles**.
4. Klaviyo processes the existing segment members and pushes them through the flow.

| **Tip:** This is a one-time action. Going forward, the flow handles new profiles automatically.

### Known Limitations

* This flow runs entirely inside Klaviyo. STOQ does not directly add profiles to Klaviyo lists; it syncs profiles, and the Klaviyo flow handles list assignment.
* If you change your **Profile tag** in STOQ after creating the segment, the segment condition no longer matches new profiles. Update the segment condition in Klaviyo to use the new tag value.
* Profiles synced before the Klaviyo integration was enabled are not in Klaviyo and cannot be added to a list through this flow.
* The **Add past profiles** option processes only profiles already in the segment at the time you run it. It does not continuously re-check.
* Double opt-in settings in Klaviyo may affect whether profiles appear as "subscribed" on the list. See your Klaviyo consent settings if profiles appear but are not subscribed.

### Troubleshooting

If profiles are not being added to your list as expected, check the table below.

| Symptom | Likely Cause | Fix |
| ---- |
| New STOQ signups do not appear in the segment | The segment condition does not match STOQ's profile tag | Open the segment in Klaviyo and verify the `source` property value matches the profile tag in STOQ's integration settings (default: `restock-rocket`) |
| Flow is not triggering | The flow status is not set to **Live** | Open the flow and change its status to **Live** in the top-right corner |
| Profiles enter the segment but are not added to the list | The **List update** action is not connected to the trigger | Open the flow editor and ensure the list update block is properly connected |
| Only some profiles are being added | A profile filter is excluding non-marketing profiles | Check the optional profile filter and remove or adjust it if you want all profiles included |
| Past profiles are missing from the list | The **Add past profiles** action was not run | Open **Manage flow** > **Add past profiles** to backfill existing segment members |
| Profile tag value is wrong in the segment | The tag was changed in STOQ after the segment was created | Update the segment condition in Klaviyo to match the current profile tag value |

### FAQs

**Q : Can I add STOQ profiles to more than one Klaviyo list?**
   A : Yes. You can either add multiple **List update** action blocks within the same flow (one for each list) or create separate flows for each list. Both approaches work.

**Q : Do I need to create the Klaviyo list before building the flow?**
   A : Yes. The list must already exist in Klaviyo so you can select it in the **List update** action. Go to **Audience** > **Lists & Segments** > **Create list / segment** > **List** to create one.

**Q : What happens if a profile is already on the list?**
   A : Klaviyo skips profiles that are already members of the list. No duplicate entries are created.

**Q : Will removing a profile from the STOQ segment also remove them from the list?**
   A : No. The flow only triggers when a profile is **added** to the segment. Removing a profile from the segment does not reverse the list addition.

**Q : Does this flow work with the StoqAcceptsMarketing property?**
   A : Yes. You can add an optional profile filter (Step 3) that checks whether `StoqAcceptsMarketing` is `true`. This restricts the flow to only marketing-consented profiles.

**Q : What is the default STOQ profile tag value?**
   A : The default value is `restock-rocket`. You can change it in the STOQ app under **Back in stock alerts** > **Settings** > **Integrations** > **Klaviyo** > **Profile tags**.