๐Ÿ“ฉKlaviyo x Smartrr Integration

Segment and target your audience in both flows and campaigns with subscription-specific triggers.

Last updated: April 13, 2024

How it works

Smartrr's integration with Klaviyo can be used in conjunction with or in place of Smartrr's native email Customer Notifications.

The following triggers are available to be passed from Smartrr to Klaviyo:

Trigger NameFired when...

Smartrr: Subscription created

๐Ÿ†• A customer has purchased a brand new subscription from your shop

Smartrr: Subscription upcoming order

๐Ÿ”œ A customer has an upcoming subscription order in 3 days

Smartrr: Subscription send now

๐Ÿ“ฆ A customer has hit Send Now on their next subscription order in their account portal Note: The "Send now" button ensures the subscription order will be processed at your shop's next Billing Time. This is different from when Shopify creates the order and an order confirmation email is sent to the customer. When using this trigger in emails, we recommend using language like: "Your order will be processed within the next 24 hours." or "Your order will be processed on the next business day."

Smartrr: Transaction successful

๐Ÿ’ณ A customer's order has successfully been run during your shop's Billing Time

Smartrr: Transaction attempt failed

โŒ A customer's order has failed during your shop's Billing Time

Smartrr: Subscription skipped

โญ A customer or admin has skipped an upcoming order

Smartrr: Subscription unskipped

โฎ A customer or admin has unskipped an upcoming order

Smartrr: Subscription gifted

๐ŸŽ A customer has gifted an upcoming order

Smartrr: Subscription next order date change

๐Ÿ“… A customer or admin has changed/delayed the date of customer's next order

Smartrr: Subscription canceled

๐Ÿ”š A customer or admin has permanently canceled a customer's recurring subscription

Smartrr: Subscription paused

โธ๏ธ A customer or admin has temporarily paused a customer's recurring subscription

Smartrr: Subscription activated (unpaused)

โ–ถ๏ธ An admin has re-activated a customer's paused subscription in the admin portal

Custom Properties

In addition to passing triggers, the following custom properties will be passed to individual Klaviyo profiles:

$email: string;
customer_shopify_id?: string;
customer_smartrr_id: string;
active_subscriptions_count: number;
customer_currency: CurrencyCode;
order_count: number;
total_spent: string;
$first_name?: string;
$last_name?: string;
$phone_number?: string;
$address1?: string;
$address2?: string;
$city?: string;
$zip?: string;
$region?: string;
$country?: string;


To integrate Klaviyo and Smartrr, grab your public API key from your Klaviyo dashboard under Account > Settings > API Keys.

Your Public API Key is pre-generated at the top of the page. Copy this key.

In your Smartrr dashboard, navigate to Integrations. Under Manual Integrations, find Klaviyo and press Connect to enter the public API key you copied from Klaviyo.

Once successfully connected, the triggers listed above will sync as soon as the metric itself fires.

Heads up: Since Smartrr syncs real-time information into Klaviyo, make sure to take this into consideration when planning out your Klaviyo flows. For example, a flow triggered by the Smartrr: subscription created metric will trigger immediately after someone subscribes, which can result in inundating customers with 3+ emails if they are already receiving both "Welcome" and "Order Confirmation" emails.

So that you can immediately begin using all Smartrr-related metrics in your Klaviyo flows, upon successful connection we will immediately create a profile in your Klaviyo "hello@smartrr.com" that will fire all 11 available triggers once. โœ…

Customer Profiles & Payloads

Once your integration is setup and syncing, you'll also be able to view subscription-level metrics detail on customer profiles within Klaviyo.

Click on Details to view the payload information that is passed along with each individual metric.

The information in the payload can be referenced as dynamic tags when designing your Klaviyo emails. For example, if you started a flow with the trigger Smartrr: Subscription created and wanted to reference one of the events in the payload, use the tag {{ event.event_name}} replacing event name with your desired variable in the body of your email.

If you have a payload in array form, such as items, you can loop through the array to find a specific result. Click here to read more about how to use Klaviyo's dynamic variable tags.

You can use Klaviyo's preview feature to help locate tags. When in preview mode for a flow email for a customer, click in the information you'd like to populate and the corresponding tag will display. In the below example, we've clicked on the with the dynamic tag for subscription frequency: {{ event.frequency_unit }} . When put into the body of an email this will render the word "month" in the customer's email.

Last updated