Klaviyo Integration

1 Prerequisites

Before connecting Klaviyo to Oriens, confirm the following:

• Oriens plan: The Klaviyo integration is available on the Starter and Growth plans. It is not available on the Free plan. You can upgrade at any time from Oriens › Settings › Billing.
• Klaviyo account: You need an active Klaviyo account. If you don't have one yet, sign up at klaviyo.com — their free tier supports up to 250 contacts.
• Price alerts widget: Make sure you've already set up the price alert subscribe widget on your product pages. If not, see the Price Alerts documentation first.

2 Find your Klaviyo Private API Key

Oriens uses a Klaviyo Private API Key to sync subscribers and fire events on your behalf.

1. Log in to your Klaviyo account.
2. Click your account name in the bottom-left corner and select Settings.
3. Navigate to the API Keys tab.
4. Click Create Private API Key.
5. Give the key a descriptive name, such as "Oriens Integration".
6. For scopes, you can grant Full Access for simplicity, or for a more restrictive setup grant at minimum:
   • Lists: Read + Write (to create and manage the Oriens subscriber list)
   • Profiles: Read + Write (to add subscribers)
   • Events: Write (to fire the price drop event that triggers your flow)
7. Click Create and immediately copy the key — Klaviyo will only display it once.

3 Paste the key into Oriens

1. In the Oriens app, go to Settings › Integrations.
2. Find the Klaviyo section and click Connect.
3. Paste your Private API Key into the field provided.
4. Click Save & Test. Oriens will make a test call to Klaviyo to verify the key is valid and has the required scopes. If the test passes, you'll see a green "Connected" status.

If the test fails, double-check that the key was copied in full (no trailing spaces) and that the required scopes are enabled.

4 Oriens subscriber list in Klaviyo

Once connected, Oriens will automatically create a Klaviyo list called "Oriens Price Alert Subscribers" in your Klaviyo account. You can rename this list in Klaviyo if you prefer, but do not delete it — Oriens uses the list ID it created and will recreate the list if it's missing.

Every time a shopper subscribes to a price alert on your store, Oriens adds their profile to this list (creating the profile if it doesn't already exist) and records the subscribed product and price as custom profile properties:

• oriens_subscribed_product — the product title
• oriens_subscribed_price — the price they subscribed at
• oriens_subscribed_variant — the variant title (e.g., "Black / L")

5 Create the Flow in Klaviyo

The price drop notification email is sent via a Klaviyo Flow triggered by a custom Oriens event. Here's how to set it up:

1. In Klaviyo, go to Flows in the left sidebar.
2. Click Create Flow.
3. Select Create from scratch.
4. Give the flow a name, e.g., "Oriens Price Drop Alert".
5. For the trigger type, select Metric.
6. In the metric search box, type Oriens Price Drop and select it. This is the custom event that Oriens fires when a subscriber's price threshold is met. (If the event doesn't appear in the list yet, it's because no price drop has occurred since you connected Klaviyo — you can proceed and the event will appear after the first alert fires, or trigger a test price drop first — see Step 9.)
7. Click Done to save the trigger.

6 Add an Email action to the flow

1. In the flow builder, click the + button below the trigger node.
2. Select Action, then Send Email.
3. Click Configure content to open the email editor.
4. Choose a template or start from scratch. See Step 7 for the available dynamic variables.

7 Customize the email template

The Oriens Price Drop event passes the following properties that you can reference anywhere in your Klaviyo email using Klaviyo's standard variable syntax: {% raw %}{{ event.property_name }}{% endraw %}.

A minimal subject line example: "Good news — {{ event.product_title }} is now {{ event.new_price }}"

8 Activate the flow

1. After finishing your email template, click Save in the email editor.
2. Back in the flow builder, click the email action node and change its status from Draft to Live using the toggle in the right panel.
3. Finally, in the top-right corner of the flow builder, change the flow status from Draft to Live.

The flow is now active. When Oriens fires an "Oriens Price Drop" event, Klaviyo will immediately queue the flow and send the email.

9 Test the integration end-to-end

1. Subscribe to a test product using your own email address via the widget on your storefront.
2. In Klaviyo, open the "Oriens Price Alert Subscribers" list and confirm your profile was added.
3. In Shopify, reduce the test product's price by at least $0.01 below the price you subscribed at.
4. In the Oriens dashboard, go to Price Alerts › Subscribers and confirm your subscription status changes to Notified.
5. In Klaviyo, go to Analytics › Metrics and search for "Oriens Price Drop" — you should see an event fire.
6. Check your inbox for the price drop notification email sent from Klaviyo.