How to connect Klaviyo

Available on

The Referral program section needs a paid plan (Starter and up), or Premium or Scale on older plans. On the Free plan its switch stays locked. The Affiliate program section is available on every plan.

Connect Klaviyo to send emails and flows to the right referrers, with their referral links and codes ready to use.

What you’ll set up

• A Klaviyo connection, using a private API key
• A profile for each referrer, with their link and code
• A segment for each campaign, and events to trigger flows

How it works

Bloop shares three things with Klaviyo:

• Profiles: each referrer’s details, campaigns, link and code.
• Segments: one per campaign. They update when someone joins or leaves.
• Events: a moment in the program, such as a referral converting. Use them to trigger flows.

Best practice

Build segments from profile properties, which describe a standing fact (who is a referrer, which campaign they’re in), such as BLOOP Successful referrals or the campaign segments. Trigger flows from events, which describe something that just happened. An event captures a moment, so a segment built on one doesn’t last.

How to connect Klaviyo

Open Settings → Store-wide → Integrations → Klaviyo. The page has one connection and two sections, Referral program and Affiliate program. Each section has its own switch and Re-sync profiles button.

1. In Klaviyo, create a private API key. Select Custom Key, then give Full Access to List, Profiles, Events and Segments.

   

2. In Bloop, turn on Referral program, Affiliate program, or both. Connect stays disabled until one of them is on.

3. Press Connect, paste the key, and press Verify. If a permission is missing, Bloop names it.

4. Press Connect to save. Bloop starts a full profile sync straight away.

Note

Read Access isn’t enough. Verify checks all four permissions before you connect.

Tip

Connect early. The first sync gives existing referrers their properties, so a segment like “all referrers” includes them.

While the sync runs

The page shows progress as N of M profiles. The sync keeps running if you leave the page.

Pause, reconnect or disconnect

• Turning a section off pauses its sync. Your key stays saved.
• Connected opens the same modal, so you can view or replace the key.
• Disconnect stops all syncing and removes the saved key. Profiles, segments and events already in Klaviyo stay there.

Warning

After you disconnect, segments and flows run on the last data synced, so new referrers don’t join them. Pause any flow that depends on new referral data before you disconnect.

Keep Klaviyo up to date

Bloop updates a profile whenever that customer changes. Press Re-sync profiles to rebuild every profile, for example after a bulk audience change.

Warning

Disabling a campaign doesn’t update Klaviyo by itself. Its link and code stay on your referrers’ profiles, so an email or flow can still send a dead link. Press Re-sync profiles right after you disable a campaign.

Only active campaigns sync. Referrers without an email address are skipped.

What’s on a referrer’s profile

Property	What it holds
BLOOP Campaigns	The campaigns they belong to
BLOOP Campaign Link {id} / BLOOP Campaign Code {id}	Their referral link and code for each campaign. Insert them into emails
BLOOP Hub Portal	A permanent link to their referral hub. Safe in flows that send days later
BLOOP Referral revenue / BLOOP Successful referrals	Lifetime totals. They don’t drop when someone leaves a campaign
BLOOP Is referrer / BLOOP Is referee	Whether they are a referrer, or were referred
BLOOP Joining date / BLOOP Joining source	When and how they joined
BLOOP Purchases needed for next reward / BLOOP Next reward description	Progress to the next tier, when tiers are on

To insert a campaign’s link, look up its property with the campaign’s id. For the campaign with id 123:

{{ person|lookup:'BLOOP Campaign Link 123' }}

Use BLOOP Campaign Code 123 for the code. To find a campaign’s id, open the campaign in Bloop: the id is the number after campaignId= in the page address. You can also open the Klaviyo profile of someone in that campaign and read their BLOOP Campaign Link {id} properties, or check the BLOOP - Campaign id field on any event Bloop sends.

Note

Older connections may still use the BLOOP Campaign Links dictionary, which is keyed by campaign name. Renaming a campaign breaks that lookup. Use the campaign id instead, after you upgrade.

Segments for each campaign

Once a campaign leaves draft, Klaviyo has a segment named BLOOP - {campaign name}. Its membership updates by itself. Use it as the recipient list for a broadcast, or with Klaviyo’s Added to segment trigger in a flow. Renaming the campaign renames the segment.

Note

Being in a segment doesn’t guarantee delivery. Klaviyo only sends broadcasts to profiles that have consented to email marketing. Check consent before you send.

Events Bloop sends

Each event appears in Klaviyo as a metric you can use as a flow trigger. Every event carries the campaign name and id, so a flow can target one campaign.

Bloop metric	Fires when	Flow ideas
BLOOP - Join program	A customer joins your program	Welcome email with their referral link
BLOOP - Referral sharing	A referrer shares their link by email	Thank them, and restate the reward
BLOOP - Referral purchase pending	A friend purchased, and the reward is under review	“Your reward is on its way”
BLOOP - Successful referral	A referral converts. Carries the reward type and code	Congratulations, with the reward code
BLOOP - Referral made ineligible	A referral is rejected	A tactful heads-up with the reason
BLOOP - Referee receives discount	The referred friend gets their discount	Remind them before the code expires
BLOOP - Left campaign	A customer leaves one campaign	Stop share reminders, or send a win-back email
BLOOP - Removed from program	A customer is removed from the program	Exclude them from all related automations

Important

If you replace Bloop’s built-in emails with Klaviyo flows, turn off the matching emails in the campaign’s Emails step. Otherwise referrers receive both.

When a customer leaves a campaign

Say your campaign targets VIP-tier customers only, and Anna drops out of that tier:

• Anna no longer qualifies for the VIP Program campaign.
• Her referral link and code for that campaign stop working.
• She leaves the BLOOP - VIP Program segment, and VIP Program disappears from her campaign list.
• The BLOOP - Left campaign event fires, so your flows can stop share reminders or send a win-back email.

Three things to know:

• The Left campaign event carries no link or code, so your flows can’t send a dead link by mistake.
• Revenue and referrals Anna brought in stay in her totals.
• If you move many customers at once, profiles and segments still update, but no events fire. Your flows never mass-email by accident.

Sync your affiliates

Turn on the Affiliate program section to send your affiliates to Klaviyo on the same connection. Its Re-sync profiles pushes every affiliate and refreshes their segments.

Affiliate properties start with BLOOP Affiliate, so they never clash with the referral properties:

What it covers	Properties
Status and dates	BLOOP Is affiliate, BLOOP Affiliate status, BLOOP Affiliate joined date
Coupon and links	BLOOP Affiliate coupon, BLOOP Affiliate link, BLOOP Affiliate portal
Campaign	BLOOP Affiliate Campaigns
Sales	BLOOP Affiliate total sales, BLOOP Affiliate commission, BLOOP Affiliate sale count

Bloop keeps two kinds of segment up to date: BLOOP - All affiliates, and one BLOOP Affiliate - {campaign name} segment for each affiliate campaign.

Bloop metric	Fires when
BLOOP - Affiliate joined program	Someone signs up through your registration form
BLOOP - Affiliate added manually	You add an affiliate yourself
BLOOP - Affiliate approved / BLOOP - Affiliate rejected	You approve or reject an application
BLOOP - Affiliate new coupon	An affiliate gets a new coupon
BLOOP - Affiliate new sale	A sale is recorded for an affiliate
BLOOP - Affiliate sale approved / BLOOP - Affiliate sale declined	You approve or decline a sale
BLOOP - Affiliate payout paid	You mark a payout as paid

The same rule applies as for referrals. If a Klaviyo flow replaces one of Bloop’s affiliate emails, turn that email off in Bloop.

Upgrade an older connection

Only needed if the Klaviyo page shows the Upgrade available badge next to Re-sync profiles. New connections already use the current format. Older connections use one of two earlier formats, and you can tell them apart on a referrer’s Klaviyo profile:

• Legacy: one BLOOP Referral link and one BLOOP Referral code on the profile.

• Campaign-based: the BLOOP Campaign Links and BLOOP Campaign Codes dictionaries, keyed by campaign name.

• You’ll see the prompt when you press Re-sync profiles, or, on the legacy format, when you create a second campaign.

• Upgrading is one-way. Press Upgrade & sync to continue, or cancel to change nothing.

• On the campaign-based format, you can choose Sync without upgrading. It re-syncs your profiles, keeps your current properties and leaves the upgrade for later.

Warning

Before you upgrade, switch every email and segment that uses the old properties to the new ones below. The upgrade clears the old dictionaries, so an email that still reads them goes out without its link or code.

Old property	Use instead
BLOOP Referral link	BLOOP Campaign Link {id}. The old property now points to the referrer’s hub
BLOOP Referral code	BLOOP Campaign Code {id}
BLOOP Campaign Links / BLOOP Campaign Codes	BLOOP Campaign Link {id} / BLOOP Campaign Code {id}

After the upgrade, BLOOP Campaigns drives your campaign segments.

Three high-value plays

• Top-referrer VIP segment. Build it on BLOOP Successful referrals at your threshold, and give those referrers richer rewards or early access.
• Reward thank-you flow. Trigger it from the BLOOP - Successful referral event, so the thank-you lands the moment a referral converts.
• Win-back leavers. Trigger it from BLOOP - Left campaign to invite the customer into another campaign. Their lifetime stats go with them.

Related

• Mailchimp integration: the equivalent integration for Mailchimp.
• Referral analytics: the in-app view of the same performance.