# Klaviyo integration

Klaviyo is a powerful email and SMS marketing platform that leverages automation to drive faster, more efficient growth. It transforms your customer data into highly personalized messages.

<figure><img src="/files/234rJIx5JeiCrFcqfPc3" alt="" width="375"><figcaption></figcaption></figure>

With this integration, you can easily manage referral campaigns and send notifications to your customers about their referral activities.

Here are some use cases for utilizing Klaviyo:

* Send welcome emails for your referral program.
* Filter and retrieve referral information of your customers.
* Automate reward notifications and updates.

Here are the steps to utilize the integration:

## Step 1. Get the Klaviyo API key

Visit the Klaviyo app to obtain your API key. Please check out this detailed guide: <https://help.klaviyo.com/hc/en-us/articles/7423954176283>

Ensuring your API key has 'Full Access' or at least the following scopes

* *Events*
* *Metrics*
* *Profiles*
* *List*

<figure><img src="/files/xXnFHXLJgILRK5Eyy75U" alt=""><figcaption></figcaption></figure>

## Step 2. Connect to Klaviyo

From the BLOOP app, go to **Integration** > **Klaviyo**. Enable the feature and enter your API key in the Connect to Klaviyo section, then click **Connect**.

<figure><img src="/files/fIilV3e9VjZIN4Z4PQuJ" alt=""><figcaption></figcaption></figure>

If the button says Connected, it means BLOOP has successfully connected to Klaviyo.

## How the integration works?

The BLOOP–Klaviyo integration includes two main functions:

### 1. Trigger Events - Send data to Klaviyo to activate email flows

BLOOP automatically sends specific events to Klaviyo whenever customers perform certain actions in your referral program. These events can be used as triggers for automated flows in Klaviyo.

<figure><img src="/files/5gWpjtvUI31q3zx1LcbC" alt=""><figcaption></figcaption></figure>

| Event                             | When it’s triggered                                                                                                             | Use case                                                                                                                            |
| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| BLOOP - Join Program              | When a customer joins the referral program through any signup point (popup, customer account, thank-you page, order page, etc.) | <p>1. Create a flow that welcomes referrers and provides their unique referral link.</p><p>2. Remind them to refer their friend</p> |
| BLOOP - Referee receives discount | When friends enter their emails to claim the rewards                                                                            | Remind friends to use their discount                                                                                                |
| BLOOP - Referral Sharing          | When a referrer sends an invitation via **email** (email only)                                                                  | Send a confirmation email to referrers when they successfully share their referral link.                                            |
| BLOOP - Successful Referral       | When the invited friend (referee) completes a purchase through the referral link                                                | Send a congratulatory email to referrers for a successful referral.                                                                 |

***Important note:***\
These events **won’t appear automatically** in your Klaviyo metrics right after connecting. To make them visible, you’ll need to **trigger them manually** by simulating a real referral process:

1. A customer joins the referral program (Join Program).
2. The customer shares their link via email (Referral Sharing).
3. A friend completes a purchase through the shared link (Successful Referral).

Once these actions are completed, Klaviyo will receive the events and you can start building your flows properly.

### 2. Sync referrer profiles automatically

BLOOP automatically syncs referrer data and custom properties into Klaviyo Profiles.  These properties store key information and the current referral status of each participant.&#x20;

You can use these custom properties to:

1. **Segment** your contacts who are part of the referral program.
2. **Personalize** your email content with referral-related data.

Let’s see this example:

<figure><img src="/files/2fWC6YhikMF1sNokTXob" alt=""><figcaption></figcaption></figure>

The above custom properties can be explained as follows:

| Property                   | Description                                                             | Example                                                           |
| -------------------------- | ----------------------------------------------------------------------- | ----------------------------------------------------------------- |
| BLOOP Is referee           | Indicates whether the person is a referee (invited friend).             | false → This person is not a referee.                             |
| BLOOP Is referrer          | Indicates whether the person is a referrer (someone who refers others). | true → This person has a referral link to share.                  |
| BLOOP Joining date         | The date and time when the person joined the BLOOP referral program.    | 2025-10-23T02:08:23.000Z → Joined on Oct 23, 2025 at 9:08 AM.     |
| BLOOP Joining source       | The registration source that shows how they joined the program.         | Self register → Joined on their own, not through a referral link. |
| BLOOP Referral code        | The unique referral code assigned to the user.                          | BLOOP\_fWODzSt0                                                   |
| BLOOP Referral link        | The user’s personal referral link for inviting friends.                 | r-bloop.cc/fWODzSt0                                               |
| BLOOP Referral revenue     | The total revenue generated from successful referrals.                  | 0 → No purchases made yet via this referral link.                 |
| BLOOP Successful referrals | The total number of successful referrals.                               | 0 → No successful referrals yet.                                  |

## How to set up email flows in Klaviyo

After connecting BLOOP with Klaviyo, you can create automated email flows triggered by the events above. We suggest 4 basic email flows that you can use in your program below:

### Flow 1 – Welcome customers to your referral program

* Trigger event: BLOOP - Join Program
* Purpose: Send a welcome email confirming the referrer has successfully joined and provide their referral link.

First, create a new flow. You will then see the following interface:

<figure><img src="/files/m9SMnCDIJExL8nuMOZ8G" alt=""><figcaption></figcaption></figure>

On the right side, click Your metrics and select API. Then, choose BLOOP - Join Program as the trigger.

<figure><img src="/files/QIGOz2cbUQWWapD0lrr3" alt=""><figcaption></figcaption></figure>

Now that the trigger is created, the next step is to create your email. The integration allows you to add custom variables into the email content, such as the BLOOP Referral Link.

<figure><img src="/files/UfPhTbyv2o5ISokbeM0R" alt=""><figcaption></figcaption></figure>

To utilize a custom variable, go to the email content editor, click Personalization, scroll down, and select the variable you want.

Here's what it looks like when you're finished:

<figure><img src="/files/OZY0TbyRgTWNEYLPFBz4" alt=""><figcaption></figcaption></figure>

### Flow 2 – Remind referrers to start referring

* Trigger event: BLOOP – Join Program
* Purpose: Send a follow-up reminder a few days after joining to encourage new referrers to share their link if they haven’t done so yet.

**Suggested setup:**

Add a conditional split (optional): for example, send this email only if the referrer has **0 successful referrals** yet.

First, choose trigger BLOOP – Join Program.&#x20;

<figure><img src="/files/AcBITkeLxeNEzKi3G8ej" alt=""><figcaption></figcaption></figure>

Optionally, add a trigger filter to only include referrers with no referrals or who haven’t shared yet:

<figure><img src="/files/Hwqjp6InZLb2Dx5hmhpk" alt=""><figcaption></figcaption></figure>

Next, add a time delay (e.g. 3 days) after the “BLOOP – Join Program” event trigger. And then, drag an Email block into your flow.

<figure><img src="/files/zdRIkqYgTIL8ix0RvcQe" alt=""><figcaption></figcaption></figure>

### Flow 3 – Confirm when a referrer shares an invitation

* Trigger event: BLOOP - Referral Sharing
* Purpose: Send a confirmation email when a referrer successfully sends an invitation.

<figure><img src="/files/CqPV6QMREARrUPYZ17Hb" alt=""><figcaption></figcaption></figure>

### Flow 4 – Congratulate referrers on a successful referral

* Trigger event: BLOOP - Successful Referral
* Purpose: Send a celebratory email to referrers when their friends complete a purchase.

<figure><img src="/files/vM0jGo6WsVm1kvPJGp8l" alt=""><figcaption></figcaption></figure>

***

That's how you can utilize the Klaviyo integration feature. If you need assistance, feel free to reach out to us via in-app Live Chat or at <support@bloop.plus>.&#x20;


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.bloop.plus/integration/klaviyo-integration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.