Skip to content

Klaviyo

Klaviyo logo next to the BSS B2B Solution logo, representing the integration between the two apps

Klaviyo is an email marketing tool for Shopify merchants, offering personalized campaign creation, customer segmentation based on shopping behavior, and automated email workflows. It helps boost sales and customer engagement directly from Shopify data.

You can check it out here: https://apps.shopify.com/klaviyo-email-marketing

Integration benefits:

  • Profile Synchronization: Effortlessly integrate wholesaler profiles from BSS B2B Solution into Klaviyo. This synchronization ensures your marketing efforts are always up-to-date and targeted.
  • Personalized Communication: Break away from standard application emails. Utilize Klaviyo to send personalized and impactful notifications to your customers. This approach not only enriches the customer experience but also aligns perfectly with your brand’s voice and messaging strategy.

To utilize the integration, please follow the below steps:

Open the Integrations page (see App Integration) and click Integrate on the Klaviyo card (the button can read Manage instead). A popup will be displayed.

Klaviyo card on Integrations with the Integrate button

Visit the Klaviyo app to obtain your API key. Need help? Check out this detailed guide: https://help.klaviyo.com/hc/en-us/articles/7423954176283

Your API key needs Full Access, or at least these two permissions:

  • Events (write)
  • Metrics (read)

Paste your key in the API key field and click Check. Turn on integration stays off until the check passes. When the key is valid you see “Your key is valid.” Tick Turn on integration and click Save.

Klaviyo dialog with an empty API key field and Check button

Congratulations! The integration is now active.

If the app cannot confirm your key, you see one of these messages:

Message What it means What to do
This key isn’t valid. Re-enter it or use another key. Klaviyo does not recognize the key. The key is not saved. Copy the key again from Klaviyo, or create a new one.
“This key is missing the Events (write) permission. In Klaviyo, create a new private key with this permission (or a Full access key), then paste it here and check again.” The key is valid but lacks a permission the integration needs. The message names the missing permission in place of “Events (write)”: Events (write), Metrics (read), or both. The key is not saved. Klaviyo does not let you change the permissions of an existing private key. Create a new private key with Events (write) and Metrics (read) (or Full Access), paste it in the API key field and click Check, then Save.
We couldn’t reach Klaviyo to check this key. You can still save it. Klaviyo did not answer. Click Save. The toast says “Saved, but we couldn’t verify the Klaviyo key yet” and the Klaviyo card shows Key not verified until you reload the page. Open Manage and click Check again later.

You can always turn the integration off, even if the saved key was revoked in Klaviyo.

Klaviyo dialog: red API key field and key isn’t valid message

Now that the integration is set up, let’s dive into how it enhances your registration process:

Diagram: a customer submits a wholesale form from BSS B2B Solution, then Klaviyo creates a wholesaler profile, triggers flows and sends notifications

When Klaviyo refuses the key while the app sends an email event, a banner appears above the integration cards:

  • Klaviyo rejected your API key (Klaviyo answered 401: the key is wrong or was revoked): shows how many emails failed since the date shown. To fix it:
    1. In Klaviyo, create a new private API key with Events (write) and Metrics (read) access, or a Full Access key.
    2. In the app, click Update API key in the banner, paste the key, click Check and Save.
    3. Open Email templates > Manage email delivery and click Resend on the failed Klaviyo emails.
  • Your Klaviyo API key is missing permissions (Klaviyo answered 403: the key lacks a permission, for example Events (write)): shows how many emails failed and which permission is missing. Permissions of an existing Klaviyo private key cannot be changed. To fix it, create a new private key with the missing permission (or a Full Access key) in Klaviyo, click Update API key in the banner, paste the key, click Check and Save.

If more emails failed than the app scans, the banner says “At least” before the number.

The app also emails you when Klaviyo rejects the key. You get at most one email every 24 hours for each problem, so a shop can receive one email for a rejected key (401) and one for missing permissions (403) in the same day. The email goes to the recipient set on the New application (to you) email template. If that template has no recipient, it goes to your shop email.

The emails the app sends to your customers keep going out as usual when their templates are on.

You can segment wholesalers by their information.

To segment wholesalers, go to Audience > Lists & segments and create a new Segment

Klaviyo Create segment page for a Wholesaler segment with the condition dropdown open on What someone has done (or not done)

In Klaviyo, you have the flexibility to segment wholesalers based on specific criteria, ensuring your marketing efforts are precisely targeted.

In the Definition section, you can choose these options:

  • What someone has done (or not done)
  • Properties about someone

There are 4 specific metrics for you to select:

  • RF - Account Approved. Activated when a wholesaler’s profile is approved.
  • RF - Account Rejected. Triggered by the rejection of a profile.
  • RF - Pending Approval. Indicates a profile is awaiting approval.
  • RF - Account Invite. Occurs when an existing store profile requires account confirmation.

Klaviyo segment builder condition where the person has RF - Account Approved at least once over all time

Profiles created through BSS B2B Solution have custom properties. These properties correspond to the fields submitted in the registration form. Their names start with RF -, for example RF - Company and RF - Phone. Section 5 lists them all.

You can use the properties for setting conditions to segment wholesalers

Klaviyo segment builder using Properties about someone with the condition RF - Company equals BSS

Utilize these segmentation options to tailor your marketing and communication strategies, ensuring they resonate with the right audience at the right time.

3. Personalized notifications with Klaviyo

Section titled “3. Personalized notifications with Klaviyo”

Leverage Klaviyo’s Flows feature to deliver tailored notifications to your wholesalers through email or SMS, ensuring each message is relevant and timely.

Begin by navigating to the Flows page within your Klaviyo dashboard. This is where you can manage and create all your automated workflows.

Click Create flow button to start the process of setting up a new, customized flow for your marketing needs.

Select “Build your own” and create flow’s name to continue

Klaviyo Create flow dialog with a flow name entered and the Create flow button

Within a flow, navigate to the Trigger section. Choose Metric to set the basis of your notification triggers.

Klaviyo flow trigger panel on the Your metrics tab listing RF - Account Approved, Account Invite, Account Rejected and Pending Approval

Select from four key metrics:

  • RF - Account Approved. Triggered when a wholesaler’s profile is approved, ideal for welcome messages.
  • RF - Account Rejected. Activates upon profile rejection, useful for feedback requests or further instructions.
  • RF - Pending Approval. Alerts when a profile is under review, keeping wholesalers informed of their status.
  • RF - Account Invite. Engages profiles that are pre-existing in your store and prompts for account confirmation.

After selecting your triggers, configure the flow’s content and frequency.

Example Klaviyo flow: RF - Account Approved trigger, a 1 minute wait, then a welcome email to the wholesaler

4. Disable data synchronization to Shopify

Section titled “4. Disable data synchronization to Shopify”

If your form uses Manual approval after registration, you should disable the option Sync profiles, profile data, and custom properties from Klaviyo to Shopify.

Registration approval options: Manual approval selected

If the synchronization option is enabled, the profiles that haven’t been approved will appear on the Shopify Admin which conflicts with the approval logic.

To disable the synchronization option, from Klaviyo, go to Integrations > Shopify.

Klaviyo account menu with Integrations highlighted and the Shopify sync settings To Shopify tab with the sync profiles checkbox cleared

5. Insert customer data variables into the Klaviyo email template

Section titled “5. Insert customer data variables into the Klaviyo email template”

When setting up the email template in Klaviyo, you might figure out that you need to insert some customer data into the email body like the customer’s last name, first name, company, or address…

Since the customer data will be stored field by field. Each field has its key. And that is what should be added to the email body.

Here is the format of data variables: {{ person|lookup:'field_key' }}

Replace field_key with one of the following keys:

No Form’s field Field label Field key Data variable
1 Email any texts email {{ person|lookup:'email' }}
2 First name any texts first_name {{ person|lookup:'first_name' }}
3 Last name any texts last_name {{ person|lookup:'last_name' }}
4 Company any texts RF - Company {{ person|lookup:'RF - Company' }}
5 Phone any texts RF - Phone {{ person|lookup:'RF - Phone' }}
6 Address any texts RF - Address {{ person|lookup:'RF - Address' }}
7 Apartment, suite, etc. any texts RF - Apartment-suite-etc. {{ person|lookup:'RF - Apartment-suite-etc.' }}
8 City any texts RF - City {{ person|lookup:'RF - City' }}
9 State any texts RF - State {{ person|lookup:'RF - State' }}
10 Zip any texts RF - Zip {{ person|lookup:'RF - Zip' }}
11 Country any texts RF - Country {{ person|lookup:'RF - Country' }}
12 EU VAT validation any texts RF - EU VAT Validation {{ person|lookup:'RF - EU VAT Validation' }}
13 ABN validation any texts RF - ABN Validation {{ person|lookup:'RF - ABN Validation' }}
14 India GST validation any texts RF - India GST Validation {{ person|lookup:'RF - India GST Validation' }}
15 UK validation any texts RF - UK Validation {{ person|lookup:'RF - UK Validation' }}
16 US EIN validation any texts RF - US EIN Validation {{ person|lookup:'RF - US EIN Validation' }}
17 Newsletter checkbox any texts RF - Subscribe to our newsletter (Yes or No) {{ person|lookup:'RF - Subscribe to our newsletter' }}
18 Custom field The field label, for example Business type RF - field label {{ person|lookup:'RF - Business type' }}

For the RF - Account Invite event, the profile also gets RF - Activation URL, the link the customer uses to activate the account: {{ person\|lookup:'RF - Activation URL' }}.