> For the complete documentation index, see [llms.txt](https://support.novel.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.novel.com/integrations/email-and-sms/klaviyo.md).

# Klaviyo

Integrate your Klaviyo emails with Novel.

<figure><img src="https://697675905-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRg00tOg8E2yOB0rdXTbu%2Fuploads%2FNqnxf5UXXCBuFHCfKnlr%2FScreenshot%202024-02-12%20at%203.39.44%E2%80%AFPM.png?alt=media&amp;token=128ca634-db41-4b41-b793-a98a8ba6a404" alt=""><figcaption></figcaption></figure>

## Overview

Integrate Novel's wallet passes into your Klaviyo emails. With this integration, you can embed personalized wallet pass URLs in your emails that enable a one-click install. Your customers don't need to login.&#x20;

To get started, you'll want to get your private API key from the Klaviyo app. You can find it under: <mark style="color:purple;">**Settings -> API Keys -> Create Private API Key -> Full Access Key**</mark>

In Novel, navigate to <mark style="color:purple;">**Integrations -> Klaviyo.**</mark> Enter your API Key, click save, and you're done!&#x20;

<figure><img src="https://697675905-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRg00tOg8E2yOB0rdXTbu%2Fuploads%2FhfxEXOh8oRXE9OiQejSR%2FScreenshot%202024-02-12%20at%203.07.41%E2%80%AFPM.png?alt=media&amp;token=067a028f-131f-4d84-bfde-6e2267951c17" alt=""><figcaption><p>Novel App (the field is now labeled "Private API Key")</p></figcaption></figure>

You'll see the following custom attributes being added to existing Klaviyo profiles that match a Shopify customer by email. Use the <mark style="color:purple;">**$NovelEmailPassLink**</mark> attribute for emails and the <mark style="color:purple;">**$NovelSmsPassLink**</mark> for SMS outreach. Novel does not create new Klaviyo profiles.

{% hint style="info" %}
It may take some time to update your profiles in Klaviyo, depending on the number of customers you have. Profiles update when you save the integration, when Shopify customers are created or updated, and when orders are placed. A full sync also runs weekly.
{% endhint %}

| Key                      | Value                                                                      |
| ------------------------ | -------------------------------------------------------------------------- |
| $NovelEmailPassLink      | <https://app.novelpasses.com/api/customer/auth/passwordless/login?token=…> |
| $NovelSmsPassLink        | https\://\[yourstorefront].novelpasses.com?userEmail=…\&sourceTag=sms      |
| $NovelStoreCreditBalance | $12.00                                                                     |

The values above are examples. Each profile shows its own links and its own store credit balance.

To use these attributes in emails, insert the following as the link URL of your Add to Wallet image or button. Don't forget to replace the \[yourstorefront] with the URL in your [Novel pass install link. ](/start-guide/distribute-your-pass.md)

We recommend that you use the *add to wallet* images in the [Novel brand kit](https://www.figma.com/file/5u5yQM726XWS0WurrX1Hcw/Novel-Brand-Kit-\(Community\)?type=design\&node-id=0%3A1\&mode=design\&t=ZNsU9QGKuJtPLptM-1) when creating your email and using the below as the URL.&#x20;

```
{{person|lookup:'$NovelEmailPassLink'|default:'https://[yourstorefront].novelpasses.com/email'}}
```

For email design help, refer to the Novel brand kit Figma below.&#x20;

{% @figma/embed fileId="5u5yQM726XWS0WurrX1Hcw" nodeId="0:1" url="<https://www.figma.com/file/5u5yQM726XWS0WurrX1Hcw/Novel-Brand-Kit-(Community)?mode=design&node-id=0:1&t=MzMXOkpt86mMltPm-1&type=design>" %}

***

### Store Credit Balance Attribute

Novel can sync a customer’s store credit balance into Klaviyo as a profile attribute.

Attribute:

```
$NovelStoreCreditBalance
```

You can use this in Klaviyo emails and flows to dynamically display each customer’s balance.

Example:

```
You currently have {{ person|lookup:'$NovelStoreCreditBalance' }} in store credit.
```

Each customer sees their own balance. For example, a customer with a $12.00 balance would see "You currently have $12.00 in store credit."

Common use cases:

* Monthly rewards emails
* VIP / loyalty updates
* Store credit reminders
* Winback campaigns

If you do not see this attribute in Klaviyo, contact Novel support to enable store credit syncing.