Connect Klaviyo (recommended). Click Connect Klaviyo, sign in to Klaviyo, and approve access. This is the quickest way and keeps the connection secure — you never have to copy any keys.

Use API keys instead. Prefer to use keys? Click Use API keys instead. A Connect with API keys window opens: paste your Public API Key and Private API Key, then click Connect to Klaviyo. You'll find both keys in Klaviyo under Settings → API keys. If Klaviyo rejects the keys, the window shows the error so you can correct them; Cancel closes it without saving.

Creates (or reuses) a Klaviyo list named Subi in your account.

Adds your subscribers who have an email address to that list as Klaviyo profiles, and keeps adding new subscribers as they sign up. The list can also hold customers who have never subscribed, if Subi already has them on record for your store, for example customers who joined your store after you turned on Subi’s loyalty program.

Matches customers by email, so existing Klaviyo profiles are updated rather than duplicated.

subi_subscription_state says where the customer stands with your subscriptions. It is active if they have at least one active subscription, paused if none is active and at least one is paused, cancelled if every subscription they had has ended, and none if they have never had one.

subi_active_subscriber is true when the customer has at least one active subscription.

subi_active_subscription_count is how many active subscriptions they have.

subi_paused_subscription_count is how many paused subscriptions they have.

subi_next_billing_date is the date of their next subscription order, the earliest one across their active subscriptions.

subi_subscriber_since is the date their first subscription with your store was created. If you moved your subscribers to Subi from another app, it can be the date of the move.

subi_last_subscription_ended_at is the date their most recent subscription ended. It is filled only when the customer has no active or paused subscription left, and empty otherwise.

Started Subscription — a customer starts a new subscription.

Canceled Subscription — a subscription is cancelled.

Paused Subscription — a subscription is paused.

Resumed Subscription — a paused subscription resumes.

Subscription Skipped — a customer skips their next order.

Subscription Expired — a subscription expires.

Subscription Billing Succeeded — a subscription order is billed successfully.

Subscription Payment Failed — a subscription payment fails.

Upcoming Subscription Order — sent 3 days before a customer's next subscription order is due.

It is on every Canceled Subscription event. In the rare case the link could not be issued, the property arrives empty — add a condition to your flow so the email never goes out with a dead button.

It restarts the subscription at its current price, with no discount attached. If you want to offer a discount, add it in your Klaviyo flow — the link itself carries none.

It stays valid for 30 days from the cancellation.

Each cancellation gets its own link. If the same subscription is canceled again later, the newer event carries a new link and the older one stops working.

Once a customer uses it, it cannot be used a second time.

After 30 days, or once it has been used, the customer sees a short page telling them the link is no longer valid, with a way to log in to their subscriptions instead.

skip_url skips the upcoming order, and the next order moves one billing interval later. On a monthly subscription with an order on October 10, the next order becomes November 10.

pause_url pauses the subscription for two orders, and it starts again on its own. On a monthly subscription with an order on October 10, no orders are made on October 10 and November 10, and orders start again with the December 10 order.

delay_url moves the upcoming order 7 days later. An order on October 10 moves to October 17.

skip_url is empty when Customer can skip their upcoming delivery is off, or when Limit number of skips is on and the customer has already used their Maximum skips. It is also empty when Set limitation to skip subscription is 4 days or more: the event is sent 3 days before the order, which is already inside that limit. With the limitation at 3 days or fewer, the link is sent.

pause_url is empty when Customer can Pause/Resume their subscription renewal is off, or when Paused subscriptions start again on a date the customer picks when pausing is off, because the link pauses with a set restart date. It is also empty when the subscription's plan has a Cancellation Policy and the customer has not yet made the number of successful payments it requires.

delay_url is empty when Customer can Reschedule their subscription is off, which is the default. It is also empty when Maximum billing cycles a customer can move the next order ahead is set and a 7-day delay would go past it. Because that limit is at least 1 billing cycle, this only affects subscriptions that renew more often than once a week.

Each link works once. Once the customer confirms, the same link cannot be used again.

A link stops working when the order is billed, when the order's date changes before then (for example the customer or you reschedule it), or when your settings no longer allow that action, for example if you turn off skipping after the email went out. The pause and delay links also stop working on the day of the order itself.

When a link no longer works, the customer sees a short page saying This link is no longer valid, with a Log in button to manage their subscription in your customer portal instead.

Subi does not keep the links. In Event history, View payload shows single-use link, not stored in place of each link, and an empty property shows as null. Klaviyo receives the real links.

Win back a cancelled subscriber — trigger on Canceled Subscription. The event carries the cancellation reason and the winback_url restart link described above.

Recover a failed payment — trigger on Subscription Payment Failed. It fires on a failed billing attempt, before Subi retries it.

Remind before the next order — trigger on Upcoming Subscription Order. It is sent three days before each renewal and carries the skip_url, pause_url and delay_url links described above, so your reminder can let the customer skip, pause or delay that order. This one is always on, so you will not find it among the events you can switch on and off on that page.

The property holds the customer's earliest upcoming order across their active subscriptions. A customer with two subscriptions gets a reminder for whichever order comes first, and may get none for the second one if it falls within your lead time.

Some date changes reach Klaviyo late: a new date set with Reschedule, a delay or frequency change a customer picks in your cancellation flow, a delay a customer confirms through the delay_url link, a bulk date edit, a date set through the API, a skip applied by payment recovery, or a change made in the Shopify admin. Klaviyo gets the new date with the customer's next order, skip, pause, resume or cancellation in Subi, and until then a reminder can go out on the old date. If your store moves dates these ways often, the Upcoming Subscription Order event is the safer trigger, because it always uses the current date.

The skip_url, pause_url and delay_url links come only with the Upcoming Subscription Order event. A flow built on subi_next_billing_date cannot include them, so keep the event as your trigger if you want those buttons in your reminder.

Paused subscribers, where subi_subscription_state equals paused. Use it for a campaign that reminds them their subscription is on hold.

Recently lapsed subscribers, where subi_subscription_state equals cancelled and subi_last_subscription_ended_at is in the last 90 days. If Klaviyo offers only text options for that date, change the condition’s data type to Date. Use it for a win-back campaign to customers whose subscriptions ended in the last three months.

Build segments from the Subi list or the subscription properties, for example everyone whose subi_subscription_state is paused, or whose subi_next_billing_date falls in the next three days.

Trigger automated emails or SMS on any Subi metric, for example a win-back flow on Canceled Subscription, a payment-update reminder on Subscription Payment Failed, or a come-back offer on Subscription Recovery Ended when a failed payment couldn't be recovered.