Klaviyo

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:
1. Enable the integration
Section titled “1. Enable the integration”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.

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.

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.

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

If Klaviyo rejects your key later
Section titled “If Klaviyo rejects your key later”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:
- In Klaviyo, create a new private API key with Events (write) and Metrics (read) access, or a Full Access key.
- In the app, click Update API key in the banner, paste the key, click Check and Save.
- 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.
Warning email
Section titled “Warning email”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.
2. Segmenting Wholesalers in Klaviyo
Section titled “2. Segmenting Wholesalers in Klaviyo”You can segment wholesalers by their information.
2.1. Start with Lists & Segments
Section titled “2.1. Start with Lists & Segments”To segment wholesalers, go to Audience > Lists & segments and create a new Segment

2.2. Define Your Segment
Section titled “2.2. Define Your Segment”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
What someone has done (or not done)
Section titled “What someone has done (or not done)”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.

Properties about someone
Section titled “Properties about someone”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

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.
3.1. Create a flow
Section titled “3.1. Create a flow”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

3.2. Select trigger metric
Section titled “3.2. Select trigger metric”Within a flow, navigate to the Trigger section. Choose Metric to set the basis of your notification triggers.

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.

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.

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.

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 | any texts | {{ 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' }}.
- Boost AI Search & FilterTurn on the Boost AI Search & Filter integration in BSS B2B Solution to show B2B prices on the Boost product grid, with no theme edit.
- BSS Apps: OPTIS Product Options and TA Subscriptions AppUse OPTIS Product Options with BSS B2B Solution so Buy it now and the cart keep B2B pricing, and find the TA Subscriptions App under Integrations > BSS apps.
- EasyCSVUse EasyCSV with BSS B2B Solution to import orders and product data while your custom B2B pricing rules keep applying.
- Kaching SubscriptionsTurn on the Kaching Subscriptions integration in BSS B2B Solution so your Custom Pricing discounts apply to the subscription price in the cart, and checkout shows that price.