Skip to main content

Klaviyo triggers and events for subscription emails

Every Klaviyo event Appstle Subscriptions sends, its exact name in Klaviyo, and when Appstle sends it.

When Klaviyo sends your subscription emails, Appstle sends Klaviyo an event each time it would have sent one of its own emails. You use that event as the trigger of a flow in Klaviyo, and the flow sends the message. This article lists every event, its exact name in Klaviyo, and when Appstle sends it.

Before you start

  • Connect Klaviyo, and keep Enable Klaviyo Email & SMS selected (connecting selects it). See Connect Klaviyo and send subscription emails through it.

  • Keep the email template turned on. Go to More → Notification Settings and open the Email Notifications tab. Each template shows Active or Inactive, with a Disable or Enable button. A template that is off sends no event.

  • Create a flow in Klaviyo for each event you want to use.

Important: While Enable Klaviyo Email & SMS is selected, Appstle sends these emails through Klaviyo only. It doesn't also send its own email, so customers get nothing for an event until its flow is live in Klaviyo.

Events and when they're sent

The first column is the event's exact name in Klaviyo. The second column starts with the matching email template on the Email Notifications tab, or the Bulk Communications tab for the four bulk events, then says when Appstle sends the event.

Event in Klaviyo

Email template and when it's sent

Create Subscription Event from Appstle

Subscription Created: a new subscription is created. Appstle sends it about 5 minutes later, and not for a gift purchase: the recipient gets the gift emails instead.

Upcoming Order Event from Appstle

Upcoming Order: a set number of days before a recurring order is billed, 1 unless you change it. Each subscription takes the number when it's created: from its plan, if the plan sets one, or else from Send Upcoming Order Email (Days Before Charge) on the template. You can change it for one subscription in the Upcoming Orders Email card on its page.

Transaction Success Event from Appstle

Transaction Success: a recurring order is billed successfully.

Transaction Failed Event from Appstle

Transaction Failed: a recurring payment fails. Appstle sends it for the first failed attempt. For later retries, it sends it only if Email the customer after each failed retry is on in Failed Payment Recovery, or if the retry offers a recovery discount. When the payment fails because an item is out of stock, Appstle sends the Out of Stock event instead.

Security Challenge Event from Appstle

Security Challenge: a payment needs the customer to confirm it with their bank.

Expiring Credit Card Event from Appstle

Expiring Credit Card: a customer's saved card is about to expire. Appstle sends it on each of the last three days of the month before the card's expiry month, once for each of the customer's active subscriptions. To send a customer one message a day, turn on smart sending in the flow.

Out of Stock Event from Appstle

Out Of Stock: a billing attempt fails because an item is out of stock.

Order skipped Event from Appstle

Order Skipped: an upcoming order is skipped.

Subscription paused Event from Appstle

Subscription Paused: a subscription is paused.

Subscription resumed Event from Appstle

Subscription Resumed: a paused subscription is resumed.

Subscription canceled Event from Appstle

Subscription Cancelled: a subscription is canceled.

Shipping Address Updated Event from Appstle

Shipping Address Updated: the shipping address of a subscription changes. In Klaviyo, this name has two spaces between Address and Updated, so pick it from the list instead of typing it.

Order Frequency Updated Event from Appstle

Order Frequency Updated: the delivery frequency of a subscription changes.

Next Order Date Updated Event from Appstle

Next Order Date Updated: the next order date of a subscription changes.

Product added in Subscription Event from Appstle

Subscription Product Added: a product is added to a subscription.

Product removed from Subscription Event from Appstle

Subscription Product Removed: a product is removed from a subscription.

Product replaced in Subscription Event from Appstle

Subscription Product Replaced: a product in a subscription is replaced with another.

Product Price Updated Event from Appstle

Product Price Updated: the price of a product in a subscription is updated.

Subscription management link sent Event from Appstle

Subscription Management Link: Appstle sends a customer a link to manage their subscription.

Cancellation Discount Applied Event from Appstle

Cancellation Discount Applied: a notification for you, not for the customer. Appstle sends it when a customer accepts a discount offer instead of canceling, and Email notifications for accepted discounts is on in Retention Management. It is sent for the Notification Email Address you set there.

Bulk all subscribers Event from Appstle

Bulk Communications: you send a bulk communication to all subscribers.

Bulk active subscribers only Event from Appstle

Bulk Communications: you send a bulk communication to active subscribers.

Bulk cancelled subscribers only Event from Appstle

Bulk Communications: you send a bulk communication to canceled subscribers.

Bulk paused subscribers only Event from Appstle

Bulk Communications: you send a bulk communication to paused subscribers.

When the customer gets no event

Appstle doesn't send the customer an event in these cases:

  • The email template is turned off.

  • The subscription is paused or canceled and Disable notifications for paused or canceled subscriptions is selected in Shop Settings → Email Notifications. These events still go out: Subscription paused, Subscription resumed, Subscription canceled, Subscription management link sent, the bulk events to all, paused and canceled subscribers, and Create Subscription for a subscription that came with an order.

  • The event is Upcoming Order and Stop sending upcoming order emails is selected in the Upcoming Orders Email card on the subscription's page.

  • The template has Only Send this email as Admin notification? selected. Appstle sends the event for the template's Admin Notification / BCC Email address instead, or sends nothing if that address is empty.

  • The email is one of the three gift emails: Gift Purchased Merchant, Gift Received and Gift Thank You. Appstle sends these itself, even while Klaviyo is on.

  • Klaviyo doesn't accept the event. Appstle doesn't send its own email instead.

Use an event in a flow

Klaviyo lists an event as a flow trigger only after it has received it once, so start with a test.

  1. Send a test from Appstle. Go to More → Notification Settings, open the Email Notifications tab and click Test Email on the template. Choose an address under Email and click Send Test Email. The list shows your Allowed Email Addresses for Notifications from Shop Settings, and only the store owner can add to it.

  2. In Klaviyo, create a flow and choose the event as its trigger. Look for the name in the first column of the table above.

  3. Add the email or SMS to the flow and use the event's data in it. See Use subscription details in a Klaviyo email.

  4. Preview the message with the test event, which is in the test address's activity in Klaviyo. Appstle fills the test with one of your active subscriptions and adds - TEST to the subject and heading.

  5. Set the flow live in Klaviyo.

Test Email doesn't send an event for the Cancellation Discount Applied template.

Appstle can also create these flows for you as drafts: one for each active email template, except the four bulk events. See Connect Klaviyo and send subscription emails through it.

Developers can find every property of every event in the Klaviyo events reference.

Things to know

If your store uses the standard customer portal, the portal link in an event (manageSubscriptionLink) signs the customer in for 2 hours after Appstle sends the event, so don't add a long delay before the email in your flow.

After 2 hours, a customer who isn't signed in to your store has to sign in. If your Customer portal login page is Live (Customer Portal → Customer Portal Login), they can enter their email address instead to get a new link.

With the advanced customer portal or Shopify's customer accounts, the link doesn't sign the customer in: they sign in as usual.

FAQs

Why didn't my customer get an email?

  • Open the subscription in Appstle and check its Activity Logs. Sent via: Klaviyo means Appstle sent the event to Klaviyo. A failed entry shows the Reason:.

  • In Klaviyo, open the customer's profile and look for the event in their activity. If it's there, check that the flow is live (a draft flow sends nothing), then check the flow's filters and smart sending. The flows Appstle creates aren't transactional, so Klaviyo also skips customers who have unsubscribed or are suppressed.

  • If the event isn't there, check that Enable Klaviyo Email & SMS is selected and the template is on, then see "When the customer gets no event".

  • If the Klaviyo Email, SMS & Contacts Sync page shows Klaviyo Connection Issue, Klaviyo no longer accepts Appstle's connection and events fail. Click Revoke, then Confirm Revoke, then Connect Klaviyo and approve the access again.

How do I go back to Appstle's emails?

Clear Enable Klaviyo Email & SMS on the Klaviyo Email, SMS & Contacts Sync page. Appstle then stops sending events and sends its own emails again, unless you have connected another email integration such as Mailchimp or Omnisend.

Did this answer your question?