For the complete documentation index, see llms.txt. This page is also available as Markdown.

Klaviyo

Connect Klaviyo to receive subscription events in real time for use in flows, segments, and campaigns.

Overview

Klaviyo is an email and SMS marketing platform for Shopify merchants. It lets you create customer segments, automate messaging, and build marketing flows based on customer activity.

By integrating TA Subscriptions App with Klaviyo, subscription events and customer data can be synced to Klaviyo for use in flows, segments, and campaigns.

With this integration, you can:

  • Synchronize customer profiles with Klaviyo.

  • Build personalized email and SMS campaigns.

  • Create customer segments based on subscription activity.

  • Trigger automated flows from subscription events.

This integration requires sharing certain customer and subscription data with Klaviyo. For details about the data shared and how it is used, see Privacy and Data Sharing.

How to Set Up

1

Get your Klaviyo API key

Go to the Klaviyo app to get your API key. You can check out this detailed guide here.

Make sure your API key has 'Full Access' or at least the following scopes:

  • Events (Full Access)

  • Metrics (Full Access)

  • Profiles (Read Access)

Copy and paste your key in the input.

2

Sync Klaviyo with TA Subscriptions App

Go to TA Subscriptions App, open Settings > Integrations > Klaviyo and turn on. Then paste the API key in step 1 in the box.

Click Connect and accept the policy. Below is what a successful connection looks like.

Choose the events you want to activate and turn on.

3

Configure your flows in Klaviyo

Create flow > Select Build your own > Name your flow to continue

Then select a trigger metric.

After selecting your triggers, configure the flow's content.

4

Add variables in email templates

You can add a number of variables into your Klaviyo email templates for better customization as well. Here are the list of variables that we offer:

Variables
Description

{{ event.order_id|default:'' }}

Order ID

{{ event.customer_id|default:'' }}

Customer ID

{{ event.contract_status|default:'' }}

Contract status, e.g.: ACTIVE, PAUSED, CANCELLED, EXPIRED, FAILED

{{ event.billing_policy_interval|default:'' }}

Billing cycle unit (DAY/WEEK/MONTH/YEAR)

{{ event.billing_policy_interval_count|default:0 }}

Number of interval units per billing cycle

{{ event.currency_code|default:'' }}

Currency code, e.g.: USD, VND, EUR

{{ event.delivery_price|default:0 }}

Delivery/shipping price

{{ event.total_amount|default:0 }}

Total order amount

5

Configure segment in Klaviyo

Audience > Lists & segments and create a new Segment

In Klaviyo, you can segment customers based on specific criteria to target your campaigns more effectively.

In the Definition section, you can choose these options:

  • What someone has done (or not done)

  • Properties about someone

Supported Events

  1. Subscription Created:Triggered when a customer starts a new subscription. Some common use cases are:

    • Welcome series, Subscriber onboarding

    • Cross-sell recommendations

    • Product education emails

  2. Subscription Activated: Triggered when a subscription becomes active. Some common use cases are:

    • Welcome subscriber campaigns

    • Loyalty program enrollment

    • Subscriber-exclusive promotions

  3. Subscription Paused: Triggered when a customer pauses their subscription. Some common use cases are:

    • Pause confirmation emails

    • Retention campaigns

    • Product recommendations, Reactivation reminders.

  4. Subscription Resumed: Triggered when a paused subscription is resumed. Some common use cases are:

    • Welcome back emails

    • Subscriber engagement campaigns

    • Upsell opportunities

  5. Subscription Cancelled: Triggered when a subscription is cancelled. Some common use cases are:

    • Win-back campaigns

    • Feedback collection

    • Retention offers

    • Reactivation discounts

  6. Upcoming Order Reminder: Triggered before an upcoming subscription order is billed. Some common use cases are:

    • Renewal reminders

    • Payment preparation reminders

    • Subscription management prompts

  7. Payment Failed: Triggered when a subscription billing attempt fails. Some common use cases are:

    • Dunning campaigns

    • Payment method update requests

    • Failed payment recovery emails

    • Customer support outreach

Privacy and Data Sharing

When you connect this integration, TA Subscriptions App shares the data required to sync subscription events with Klaviyo in real time.

The data shared may include:

  • Customer information (Protected Customer Data): Customer email address, customer name (when available), and customer identifiers required to associate events with the correct Klaviyo profile.

  • Subscription information: Subscription creation, activation, renewals, updates, pauses, resumptions, cancellations, billing status, and other subscription lifecycle events.

  • Subscription order information: Subscription order events, subscription plan details, products, quantities, billing dates, and related order information used for customer messaging, segmentation, and marketing automation.

TA Subscriptions App only shares the minimum data required to provide this integration. Payment credentials, payment method details, Shopify authentication tokens, and other sensitive authentication information are never shared with Klaviyo.

Data received by Klaviyo is processed according to Klaviyo's own Privacy Policy and Terms of Service. By enabling this integration, you acknowledge that customer data will be shared with Klaviyo for the purpose of providing the integration and that you are responsible for complying with applicable privacy laws and obtaining any required customer consent.

You can disconnect this integration at any time from Settings → Integrations → Klaviyo in TA Subscriptions App. Once disconnected, no new subscription events will be sent to Klaviyo. Previously synced data will remain in your Klaviyo account unless you remove it there.

Important Notes

  • Only events that occur after the integration is enabled will be synced to Klaviyo.

  • Some events may not be available depending on your Klaviyo account configuration.

  • We recommend testing flows and segments before launching live campaigns.

  • Previously synced events and customer data are not automatically removed from Klaviyo after the integration is disconnected.

If you need help, feel free to reach out to us via in-app Live chat, Book a call or at [email protected].

Last updated