Rivalry2

HTML Diff

21 added 23 removed

Original 2026-01-01

Modified 2026-03-10

1 Solution Recipes are tutorials to achieve specific objectives in Klaviyo. They can also help you master Klaviyo, learn new third-party technologies, and come up with creative ideas. They are written mainly for developers & technically-advanced users.

2 - Note:We do our best to make sure any code and API references are accurate and current when this is published, but you might need to update code and it’s always a best practice to leverage our<a>latest API versions</a>. If you have questions, feel free to hop over to our<a>Developer Community</a>.

2 + Note:We do our best to make sure any code and API references are accurate and current when this is published, but you might need to update code and it’s always a best practice to leverage our<a>latest API versions</a>. If you have questions, feel free to hop over to our<a>Developer Community</a>.

3 What you’ll learn

4 - Klaviyo has powerful built-in <a>segmentation</a> capabilities, where you can target profiles based on their properties and on actions (metrics) they have taken, and can further fine-tune the segmentation to properties of those metrics. This article will build on <a>Solution Recipe 10: Use webhooks in flows to send additional event and profile data into Klaviyo</a>, to permit more fine-grained segmentation based on actions profiles have taken.

4 + Klaviyo has powerful built-in<a>segmentation</a>capabilities, where you can target profiles based on their properties and on actions (metrics) they have taken, and can further fine-tune the segmentation to properties of those metrics. This article will build on<a>Solution Recipe 10: Use webhooks in flows to send additional event and profile data into Klaviyo</a>, to permit more fine-grained segmentation based on actions profiles have taken.One common use case is to target high-spending customers, specifically customers who have placed orders above a certain value threshold in a given time period. Using the built-in Klaviyo tools, you can segment profiles by thetotalvalue of their orders in a time period, but not based on the value ofindividualorders. For example, suppose we want to segment profiles who have placedoneorder of at least $1,000, versus profiles who have placed 50 orders of $20 apiece (for a total of $1,000).Using a combination of Klaviyo flows, webhooks and template<a>tagging</a>, we can store dynamically-updated profile properties whose values we can use to extend Klaviyo segmentation.

5 - One common use case is to target high-spending customers, specifically customers who have placed orders above a certain value threshold in a given time period. Using the built-in Klaviyo tools, you can segment profiles by the total value of their orders in a time period, but not based on the value of individual orders. For example, suppose we want to segment profiles who have placed one order of at least $1,000, versus profiles who have placed 50 orders of $20 apiece (for a total of $1,000).

6 - Using a combination of Klaviyo flows, webhooks and template <a>tagging</a>, we can store dynamically-updated profile properties whose values we can use to extend Klaviyo segmentation.

7 Why it matters

5 Why it matters

8 Klaviyo’s segmentation capabilities are among its most powerful features, and being able to further segment profiles based on the actions they have taken allows you to take full advantage of Klaviyo.

6 Klaviyo’s segmentation capabilities are among its most powerful features, and being able to further segment profiles based on the actions they have taken allows you to take full advantage of Klaviyo.

9 Level of sophistication

7 Level of sophistication

10 Moderate

8 Moderate

11 <h2>Prerequisite</h2>

9 <h2>Prerequisite</h2>

12 - Read <a>Solution Recipe 10: Use webhooks in flows to send additional event and profile data into Klaviyo</a> to learn how Klaviyo flow webhooks work, and how you can use them to call the Klaviyo track and identify APIs to set profile properties and add custom metrics.

10 + Read<a>Solution Recipe 10: Use webhooks in flows to send additional event and profile data into Klaviyo</a>to learn how Klaviyo flow webhooks work, and how you can use them to call the Klaviyo track and identify APIs to set profile properties and add custom metrics.

13 - Because this recipe uses webhook flow actions, you will need to enable <a>two-step authentication</a> on your Klaviyo account.

11 + Because this recipe uses webhook flow actions, you will need to enable<a>two-step authentication</a>on your Klaviyo account.

14 <h2>Introduction</h2>

12 <h2>Introduction</h2>

15 - In our example, we have a basic Placed Order metric (created with the <a>Track Profile Activity</a> API), that contains a timestamp, an array of ordered items, and a value.

13 + In our example, we have a basic Placed Order metric (created with the<a>Track Profile Activity</a>API), that contains a timestamp, an array of ordered items, and a value.

16 { "created_at": "2022-09-22T20:41:17.298858", "items": [ { "ProductName": "Brooklyn Bridge Canvas Print", "Size": "small" }, { "ProductName": "Brooklyn Bridge Canvas Print", "Size": "medium" }, { "ProductName": "Brooklyn Bridge Canvas Print", "Size": "small" } ], "$value": 1359 }We have two goals:

14 { "created_at": "2022-09-22T20:41:17.298858", "items": [ { "ProductName": "Brooklyn Bridge Canvas Print", "Size": "small" }, { "ProductName": "Brooklyn Bridge Canvas Print", "Size": "medium" }, { "ProductName": "Brooklyn Bridge Canvas Print", "Size": "small" } ], "$value": 1359 }We have two goals:

17 <ul><li>build a segment of all profiles who have placed an individual order of at least a certain value within the past 30 days</li>

15 <ul><li>build a segment of all profiles who have placed an individual order of at least a certain value within the past 30 days</li>

18 <li>build a segment of all profiles who have ordered an item whose size (photo print size in this case) is a certain value (e.g. “medium” or “large”) in the past 30 days</li>

16 <li>build a segment of all profiles who have ordered an item whose size (photo print size in this case) is a certain value (e.g. “medium” or “large”) in the past 30 days</li>

19 - </ul>We will build a flow that is triggered off the Placed Order event, and which uses webhooks with the <a>Identify Profile</a> API to save profile properties that come from the event data, e.g. the order’s value and the size property of ordered items.

17 + </ul>We will build a flow that is triggered off the Placed Order event, and which uses webhooks with the<a>Identify Profile</a>API to save profile properties that come from the event data, e.g. the order’s value and the size property of ordered items.

20 <h2>Instructions</h2>

18 <h2>Instructions</h2>

21 <h3>Step 1: Build the flow</h3>

19 <h3>Step 1: Build the flow</h3>

22 Here is how the flow will look when completed. It is triggered off the “Placed Order” event that our e-commerce integration sends to Klaviyo when customers place orders.

20 Here is how the flow will look when completed. It is triggered off the “Placed Order” event that our e-commerce integration sends to Klaviyo when customers place orders.

23 We are going to store two profile properties, one whose value is the date of the highest value order the profile placed within the past 30 days, and a second property whose value is the monetary value of that order.

21 We are going to store two profile properties, one whose value is the date of the highest value order the profile placed within the past 30 days, and a second property whose value is the monetary value of that order.

24 - We first check whether the profile has placed any other orders in the past 30 days. If they have not, then we know that this current order is by definition the highest value order in the past 30 days, and we do not need to do any comparison of the current order’s value with the profile properties we are storing. Because the current order that triggered the flow is included in the conditional split count, we set the condition to “has placed at most one order in the past 30 days”.

22 + We first check whether the profile has placed any other orders in the past 30 days. If they have not, then we know that this current orderisby definition the highest value order in the past 30 days, and we do not need to do any comparison of the current order’s value with the profile properties we are storing. Because thecurrentorder that triggered the flow is included in the conditional split count, we set the condition to “has placed at most one order in the past 30 days”.

25 In this case, we add the following webhook action.

23 In this case, we add the following webhook action.

26 - The destination URL of the webhook is Klaviyo’s Identify API - <a>https://a.klaviyo.com/api/identify</a>

24 + The destination URL of the webhook is Klaviyo’s Identify API -<a>https://a.klaviyo.com/api/identify</a>

27 The webhook JSON body is as follows:

25 The webhook JSON body is as follows:

28 - { "token": "[public key]", "properties": { "$email": "{{ person.email }}", "highest_order_value": {{ event|lookup:'$value'|default:0 }}, "highest_order_date": "{{ event.created_at }}" } }Replace [public key] with your Klaviyo account’s 6-character <a>public key</a>.

26 + { "token": "[public key]", "properties": { "$email": "{{ person.email }}", "highest_order_value": {{ event|lookup:'$value'|default:0 }}, "highest_order_date": "{{ event.created_at }}" } }Replace[public key]with your Klaviyo account’s 6-character<a>public key</a>.

29 - You may need to change {{ event.created_at }} to use whatever event property stores the date of the current order. You can also use the Django 1 now <a>tag</a>.

27 + You may need to change{{ event.created_at }}to use whatever event property stores the date of the current order. You can also use the Django now<a>tag</a>.

30 Suppose the following Placed Order event triggered the flow:

28 Suppose the following Placed Order event triggered the flow:

31 If this is the profile’s first order in 30 days, the following profile properties will be saved:

29 If this is the profile’s first order in 30 days, the following profile properties will be saved:

32 - If the profile has placed at least one other order in the past 30 days, then we need to compare the value of the current order against the value of 1 highest_order_value stored in the profile, and only update the profile property if the current order’s value is higher.

30 + If the profilehasplaced at least one other order in the past 30 days, then we need to compare the value of the current order against the value of highest_order_value stored in the profile, and only update the profile property if the current order’s value is higher.

33 - Here is the webhook action JSON body for the “No” branch of the conditional split, meaning the profile has placed at least one other order in the past 30 days. The URL remains <a>https://a.klaviyo.com/api/identify</a>

31 + Here is the webhook action JSON body for the “No” branch of the conditional split, meaning the profilehasplaced at least one other order in the past 30 days. The URL remains<a>https://a.klaviyo.com/api/identify</a>

34 - {% with profile_order_value=person|lookup:'highest_order_value'|floatformat:"0" %} {% with order_value=event|lookup:'$value'|floatformat:"0" %} {% if profile_order_value < order_value %} { "token": "[public key]", "properties": { "$email": "{{ person.email }}", "highest_order_value": {{ order_value }}, "highest_order_date": "{{ event.created_at }}" } } {% else %} { "token": "[public key]", "properties": { "$email": "{{ person.email }}" } } {% endif %} {% endwith %} {% endwith %}We only update highest_order_value and highest_order_date if the value stored in the profile for the highest recent order value is less than the value of the current order. Otherwise, we would ideally want to cancel the webhook call, but since we cannot do that, we send a “dummy” webhook call that does not update any new profile properties.

32 + {% with profile_order_value=person|lookup:'highest_order_value'|floatformat:"0" %} {% with order_value=event|lookup:'$value'|floatformat:"0" %} {% if profile_order_value < order_value %} { "token": "[public key]", "properties": { "$email": "{{ person.email }}", "highest_order_value": {{ order_value }}, "highest_order_date": "{{ event.created_at }}" } } {% else %} { "token": "[public key]", "properties": { "$email": "{{ person.email }}" } } {% endif %} {% endwith %} {% endwith %}We only updatehighest_order_valueandhighest_order_dateif the value stored in the profile for the highest recent order value isless thanthe value of the current order. Otherwise, we would ideally want to cancel the webhook call, but since we cannot do that, we send a “dummy” webhook call that does not update any new profile properties.

35 <h3>Step 2: Build the segment</h3>

33 <h3>Step 2: Build the segment</h3>

36 Once the flow is live and the profile properties start being added, we can create a segment of profiles who have placed an order of at least a certain value in the past 30 days:

34 Once the flow is live and the profile properties start being added, we can create a segment of profiles who have placed an order of at least a certain value in the past 30 days:

37 - We want to look for all profiles whose highest_order_date is within 30 days, and whose highest_order_value is at least our threshold. As new profiles place orders above this threshold, they will be added to this segment, and as profiles who had placed such orders at one point but no longer are, they will be removed from the segment.

35 + We want to look for all profiles whosehighest_order_dateis within 30 days, and whosehighest_order_valueis at least our threshold. As new profiles place orders above this threshold, they will be added to this segment, and as profiles who had placed such orders at one point but no longer are, they will be removed from the segment.

38 - If we want to find profiles who have ever placed such a high-valued order, regardless of when, we can remove the first condition of the segment definition.

36 + If we want to find profiles who haveeverplaced such a high-valued order, regardless of when, we can remove the first condition of the segment definition.

39 <h3>Step 3 (optional): Save ordered item properties to profiles</h3>

37 <h3>Step 3 (optional): Save ordered item properties to profiles</h3>

40 Our example Placed Order data includes details about the ordered items, in this case, a photo size:

38 Our example Placed Order data includes details about the ordered items, in this case, a photo size:

41 - { "ProductName": "Brooklyn Bridge Canvas Print", "Size": "small" }Suppose we want to segment on profiles who have ordered photos of certain sizes. With the native segmentation features, we can segment on <a>top-level properties</a> of event data. With this solution recipe, we can save profile properties whose values are nested non-top level values of the event data.

39 + { "ProductName": "Brooklyn Bridge Canvas Print", "Size": "small" }Suppose we want to segment on profiles who have ordered photos of certain sizes. With the native segmentation features, we can segment on<a>top-levelproperties</a>of event data. With this solution recipe, we can save profile properties whose values arenestednon-top level values of the event data.

42 - Add a webhook action to the flow, with the same URL of <a>https://a.klaviyo.com/api/identify</a>, with the following JSON body. It should be outside the “has placed an order in the past 30 days” conditional split, because we do not have to worry about comparing numeric values of orders like we did with the original webhook.

40 + Add a webhook action to the flow, with the same URL of<a>https://a.klaviyo.com/api/identify</a>, with the following JSON body. It should be outside the “has placed an order in the past 30 days” conditional split, because we do not have to worry about comparing numeric values of orders like we did with the original webhook.

43 - { "token": "[public key]", "properties": { "$email": "{{ person.email }}", "small_order_date": "{% for item in event.items %}{% if item.Size == "small" %}{{ event.created_at }}{% endif %}{% endfor %}", "medium_order_date": "{% for item in event.items %}{% if item.Size == "medium" %}{{ event.created_at }}{% endif %}{% endfor %}", "large_order_date": "{% for item in event.items %}{% if item.Size == "large" %}{{ event.created_at }}{% endif %}{% endfor %}", "xlarge_order_date": "{% for item in event.items %}{% if item.Size == "xlarge" %}{{ event.created_at }}{% endif %}{% endfor %}" } }For each possible value of the print size, we save a profile property such as medium_order_date, and to determine its value, we loop through each of the items of the order and check whether the item’s Size property is the value in question. If so, we set the value to the order’s date, so the profile property reflects the date of the most recent order that had an item meeting the corresponding condition.

41 + { "token": "[public key]", "properties": { "$email": "{{ person.email }}", "small_order_date": "{% for item in event.items %}{% if item.Size == "small" %}{{ event.created_at }}{% endif %}{% endfor %}", "medium_order_date": "{% for item in event.items %}{% if item.Size == "medium" %}{{ event.created_at }}{% endif %}{% endfor %}", "large_order_date": "{% for item in event.items %}{% if item.Size == "large" %}{{ event.created_at }}{% endif %}{% endfor %}", "xlarge_order_date": "{% for item in event.items %}{% if item.Size == "xlarge" %}{{ event.created_at }}{% endif %}{% endfor %}" } }For each possible value of the print size, we save a profile property such asmedium_order_date, and to determine its value, we loop through each of the items of the order and check whether the item’sSizeproperty is the value in question. If so, we set the value to the order’s date, so the profile property reflects the date of the most recent order that had an item meeting the corresponding condition.

44 (Note again that you will need to use the actual event data property names for your particular e-commerce platform.)

42 (Note again that you will need to use the actual event data property names for your particular e-commerce platform.)

45 Here are example profile properties that will be saved from this webhook:

43 Here are example profile properties that will be saved from this webhook:

46 <h3>Step 4 (optional): Build segments for additional order properties</h3>

44 <h3>Step 4 (optional): Build segments for additional order properties</h3>

47 Suppose we want to find all profiles who have placed an order with a medium photo print within the past 30 days. Here is the segment we would add:

45 Suppose we want to find all profiles who have placed an order with a medium photo print within the past 30 days. Here is the segment we would add:

48 <h2>Enhancements and limitations</h2>

46 <h2>Enhancements and limitations</h2>

49 <h3>Further date-based segmentation</h3>

47 <h3>Further date-based segmentation</h3>

50 - We could add conditional splits for other date ranges beyond 30 days, e.g. 60 and 90 days, and save profile properties such as60_day_highest_order_valueand 60_day_highest_order_date. We can then build segments based on profiles who have placed orders of certain values within these varying date ranges.

48 + We could add conditional splits for other date ranges beyond 30 days, e.g. 60 and 90 days, and save profile properties such as60_day_highest_order_valueand60_day_highest_order_date. We can then build segments based on profiles who have placed orders of certain values within these varying date ranges.

51 <h3>Historical orders</h3>

49 <h3>Historical orders</h3>

52 Because we need the flow to save the profile properties as orders are placed, we will not be able to start building segments until the flow is live and orders start coming into Klaviyo. Orders placed before the flow was enabled, or orders imported via a historical CSV upload, will not trigger the flow, and therefore won’t cause the profile properties to be set.

50 Because we need the flow to save the profile properties as orders are placed, we will not be able to start building segments until the flow is live and orders start coming into Klaviyo. Orders placed before the flow was enabled, or orders imported via a historical CSV upload, will not trigger the flow, and therefore won’t cause the profile properties to be set.

53 - If you have an offline process that can take historical orders and use the same logic as the flow to generate the values of the profile properties that the flow sets, you could do a <a>bulk CSV update</a> of profiles with earlier placed orders, using the same profile property names the flow updates. Your segments will then include profiles who placed orders before the flow was created and turned on.

51 + If you have an offline process that can take historical orders and use the same logic as the flow to generate the values of the profile properties that the flow sets, you could do a<a>bulk CSV update</a>of profiles with earlier placed orders, using the same profile property names the flow updates. Your segments will then include profiles who placed orders before the flow was created and turned on.

54 <h2>Learn more!</h2>

52 <h2>Learn more!</h2>

55 - If you’re interested in learning more about Klaviyo’s developer experience and APIs, please visit <a>developers.klaviyo.com</a>!

53 + If you’re interested in learning more about Klaviyo’s developer experience and APIs, please visit<a>developers.klaviyo.com</a>!