Skip to main content

Connect Klaviyo to send your loyalty emails

Connect Klaviyo so it sends your loyalty emails, and see which events and customer properties Appstle sends to Klaviyo.

Connect your Klaviyo account to Appstle Loyalty & Rewards to send your loyalty emails from Klaviyo. Appstle sends Klaviyo an event each time a loyalty email is due, and a flow you build in Klaviyo emails the customer. Appstle also keeps each customer's points, store credit and VIP tier on their Klaviyo profile.

Important: once Klaviyo is connected, Appstle stops sending these loyalty emails itself. Customers get an email only if a flow in Klaviyo is set up for that event, so build your flows right after you connect.


Before you start

  • Turn on the Appstle Loyalty app embed in your theme. While it's off, Appstle sends no loyalty emails, so Klaviyo gets no events. See Set up your loyalty program.

  • Have a Klaviyo account you can sign in to.

  • Allow pop-ups for your Shopify admin. Klaviyo opens in a new tab when you click Connect Klaviyo.

  • In More → Email Templates, turn on each email you want customers to get. Appstle only sends an event to Klaviyo for emails that are turned on.


Connect Klaviyo

  1. In Appstle Loyalty & Rewards, go to More → App Integrations.

  2. On the Klaviyo Email card, click Set up.

  3. In the Connect your Klaviyo Account window, click Connect Klaviyo. Klaviyo opens in a new tab.

  4. Sign in to Klaviyo if it asks, then approve the access Appstle requests. This includes your account details, events, flows, lists, profiles, subscriptions and templates.

  5. Klaviyo then opens the app's Klaviyo Account page in that tab. Under Connected Klaviyo Account, it shows your Klaviyo organization name and account ID, and the Klaviyo Email card on App integrations now shows Enabled. If you go back to your first tab, reload it.

  6. Click Create Sample Template at the top of the page. This adds Appstle Loyalty Email Template to your Klaviyo templates. One template works for every event (see below). The window from step 3 calls this button Create Templates.

This is the window that opens in step 3.

When you connect, Appstle also sends Klaviyo one sample event for each email template, so every event appears in Klaviyo's flow triggers. It then starts syncing your customers' profiles.


Set up your flows in Klaviyo

Appstle sends one Klaviyo event for each type of loyalty email. In Klaviyo, create a flow for each email you want to send, use the matching event as the flow's trigger, and add an email to the flow. Turn the flow on when you're done.

This table shows each email in More → Email Templates, when Appstle sends it, and its event in Klaviyo.

Email in Email Templates

Event in Klaviyo

Welcome Email: a customer signs up.

Welcome event from Appstle Loyalty

Point Earn: a customer earns points.

Point earn event from Appstle Loyalty

Credits Earn: a customer earns store credit.

Store Credit earn event from Appstle Loyalty

Point Redeem: a customer redeems points.

Point redeem event from Appstle Loyalty

Reward Available Reminder: a customer gets a new reward.

Reward available reminder event from Appstle Loyalty

Monthly Reward Reminder: a reminder of a customer's points and rewards.

Monthly reward reminder event from Appstle Loyalty

Points Expiring Reminder: before a customer's points expire.

Reward expiring reminder event from Appstle Loyalty

Discount Expiring Reminder: before a customer's discount code expires.

Discount expiring reminder event from Appstle Loyalty

Birthday: on the customer's birthday.

Birthday Reward event from Appstle Loyalty

Send referral invite to new customer: a customer invites a friend. Klaviyo gets it on the friend's profile.

Send referral invite to new customer event from Appstle Loyalty

Referral Acceptance Confirmation for new customer: tells the friend the referral was accepted and that they need to create an account.

Referral Acceptance Confirmation for new customer event from Appstle Loyalty

Referral Acceptance Confirmation for existing customer: tells the customer who referred a friend that the friend accepted.

Referral Acceptance Confirmation for existing customer event from Appstle Loyalty

VIP Tier Achieved: a customer reaches a VIP tier.

Vip tier achieved event from Appstle Loyalty

VIP Tier Expiring Reminder: before a customer's VIP tier expires.

Vip tier expiring reminder event from Appstle Loyalty

VIP Tier Upgrade Reminder: encourages a customer to earn more points to reach the next tier.

Vip tier upgrade reminder event from Appstle Loyalty

Each event carries everything the matching Appstle email would show: the subject, heading and text you set in More → Email Templates, plus the customer's points and any reward or code.

The Appstle Loyalty Email Template from step 6 works for every event and shows that content, so you keep editing the wording in Appstle. To use it, choose it as the email's template in each flow and enter {{ event.subject }} as the subject line.

You can also design your own email in Klaviyo. To add the event's details to it, use the property names from the Klaviyo events reference on Appstle's developer site.


Loyalty details on Klaviyo profiles

Appstle updates a customer's Klaviyo profile when you connect, and again when their points, store credit or VIP tier change. The profile gets these properties, which you can use in Klaviyo segments and emails.

Property

What it holds

availablePoints

The customer's available points.

availableStoreCredits

availableStoreCreditsCurrency

The customer's store credit balance and its currency.

vipTier

The customer's current VIP tier.

nextVipTier

nextVipTierMilestone

remainingToNextVipTier

nextVipTierProgressPercent

The next tier, what it takes to reach it, how much is left, and the progress as a percent.

loyaltyStatus

The customer's status: ACTIVE for customers in your program.

loyaltyReferralLink

The customer's referral link.

dob

The customer's birthday, when you have it.

lastActivityDate

pointsExpireDate

The customer's last loyalty activity and, if your points expire, the date theirs expire.

customerFrom

Always "Appstle Loyalty".

This update only changes profiles that already exist in Klaviyo. It doesn't create new ones. Customers who haven't joined the program yet are skipped too, when Require Customers to Opt In to the Loyalty Program is on in More → Advanced Settings. Events work differently: when Appstle sends an event for a customer with no Klaviyo profile, Klaviyo creates one so your flow can email them.

Choose which customers sync

In More → Advanced Settings, the Klaviyo Profile Sync setting decides who gets updated. All Customers is the default. Marketing Enable Only updates only customers who have accepted email marketing.


If you connected with API keys

Earlier versions of this integration asked for a Klaviyo public API key and private API key. Klaviyo has deprecated that sign-in method. If you set it up that way, a Klaviyo Integration Update banner shows on the Dashboard and on Email Templates. Click Connect in the banner, then follow steps 4 to 6 above. Appstle removes your old keys once the new connection works.


Disconnect Klaviyo

On the Klaviyo Email card, click Set up, then click Revoke. You can also click Revoke on the Klaviyo Account page. Appstle removes its access to your Klaviyo account and adds an Integration Disabled entry to More → Activity Logs. Loyalty emails are then sent by Appstle again, or through Mailchimp or Omnisend if you've connected one of them. The Monthly Reward Reminder stops unless Omnisend is connected.


Things to know

  • Klaviyo takes priority. While it's connected, Appstle sends no loyalty emails itself and none through Mailchimp or Omnisend.

  • The wording, logo and colors you set for each email in More → Email Templates go to Klaviyo with the event, and the Appstle Loyalty Email Template shows them. Each email's on/off switch and its Restrict Customer Tags and Allow Customer Tags still decide which customers get an event.

  • While Klaviyo is connected, the Admin Notification / BCC Email you set for an email in More → Email Templates no longer gets a copy. If Only Send this email as Admin Notification? is on, the event goes to that address instead of the customer, as Appstle's own email would.

  • The Monthly Reward Reminder email works only through Klaviyo or Omnisend. Once Klaviyo is connected, you can turn it on in More → Email Templates.

  • The sample events use the address [email protected], so a profile with that address can appear in your Klaviyo account.


Troubleshooting

  • Customers don't get loyalty emails. Check that a flow exists in Klaviyo for the event, that it is turned on, and that its email is live.

  • The event never reaches Klaviyo for a customer. Open More → Activity Logs and find the customer's email entry. Its note gives the reason. Appstle skips the event, just as it would skip its own email, when:

    • the email is turned off in More → Email Templates, or its Restrict Customer Tags or Allow Customer Tags leave the customer out

    • the customer isn't covered by Send Emails To in More → Advanced Settings, or Enable Email is off for them

    • the customer has unsubscribed or their address bounces

    • the Appstle Loyalty app embed is off, or Show loyalty on your store is off in Design

  • The events don't appear in Klaviyo. On More → App Integrations, check that the Klaviyo Email card shows the Enabled badge. If it doesn't, connect again.

  • Connect Klaviyo does nothing. Your browser probably blocked the new tab. Allow pop-ups for your Shopify admin and click the button again.

  • The page shows "Denied Permissions". Klaviyo didn't get your approval. Click Connect on that page and approve the access in Klaviyo.

  • Create Sample Template shows an error. Reconnect Klaviyo and try again.

  • A customer's loyalty properties are missing in Klaviyo. The customer needs an existing Klaviyo profile. If Klaviyo Profile Sync is set to Marketing Enable Only, they also need to have accepted email marketing.

  • A test email from Email Templates never arrives. While Klaviyo is connected, Test Email sends the event to Klaviyo instead of an email. Turn on the flow for that event, then send the test again.


FAQs

Can I use Klaviyo and Appstle's own emails together?

No. While Klaviyo is connected, every loyalty email goes to Klaviyo as an event, and Appstle sends none itself. To have Appstle send them again, disconnect Klaviyo as described above.

Do I need to create the flows myself?

Yes. Appstle sends the events and the sample template, and you build the flows in Klaviyo.

What does Appstle do in my Klaviyo account?

It sends the loyalty events, adds the sample template when you click Create Sample Template, and updates loyalty properties on profiles you already have. It reads your organization name and account ID to show them in the app, and looks up profiles by email to find the ones to update.

Did this answer your question?