> ## Documentation Index
> Fetch the complete documentation index at: https://help.emotive.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Klaviyo and Emotive

> Sync contacts, lists, and data between Emotive and Klaviyo.

## Install Klaviyo on Emotive

* Navigate to [Integrations](https://www.emotiveapp.co/settings/integrations).
* Locate **Klaviyo** and select **Add Integration**.
* Insert your Klaviyo Public API Key.
* Insert your Klaviyo Private API Key.
* Configure your preferences under the *Sync Data* section.
* Click **+ Import** if you'd like to import any Lists from Klaviyo.
* **Save** your changes.

<img src="https://mintcdn.com/emotiv/GelXjFfUGXsTSetw/images/integrations/klaviyo-credentials.png?fit=max&auto=format&n=GelXjFfUGXsTSetw&q=85&s=e45b1c7f52c80cbe43400ffaaffa3214" alt="klaviyo credentials" height="200" className="integrations" data-path="images/integrations/klaviyo-credentials.png" />

<Note>
  If you opt to sync any Klaviyo Lists to Emotive, they will appear in your Emotive segment list for both your Broadcasts and Flows.
</Note>

## Syncing SMS Contacts from Klaviyo Forms

Before you get started with syncing SMS signups from Klaviyo to Emotive, you will need to:

1. Enable Klaviyo SMS
2. Create a Klaviyo List for Emotive Subscribers

### Create a Signup Flow in Klaviyo

* Log into Klaviyo and navigate to **Sign-up Forms**.
* Edit **Sign-up Forms**.
* Set up the phone number step's Button *Action* to "Submit Form".
* Your *List to Submit* should be the one you will connect to Emotive.
* Add 2 new *Profile Properties*.
  * Name = "emotive\_source"
    * Value = "true"
  * Name = "emotive\_sms"
    * Value = "true"
* **Publish** changes.

<img src="https://mintcdn.com/emotiv/sgYvST6NOqMHyLcF/images/integrations/emotive-klaviyo-sms-form.png?fit=max&auto=format&n=sgYvST6NOqMHyLcF&q=85&s=437f7f8e687bef901788d734bafc219d" alt="screenshot showing a signup flow in the emotive form builder" height="200" className="integrations" data-path="images/integrations/emotive-klaviyo-sms-form.png" />

### Configure your List Settings

* Navigate to your **Lists & Segments** in Klaviyo.
* Edit your new Emotive subscribers **List.**
* Navigate to **Settings** > **Consent.**
* In your *Opt-In Process* settings, select **Single opt-in.**
* **Save** your changes.

<img src="https://mintcdn.com/emotiv/GelXjFfUGXsTSetw/images/integrations/klaviyo-forms-list-settings.png?fit=max&auto=format&n=GelXjFfUGXsTSetw&q=85&s=621aeb52e21419d178b6179663b88712" alt="klaviyo list settings" height="200" className="integrations" data-path="images/integrations/klaviyo-forms-list-settings.png" />

### Create a List Growth Integration

* Log into Emotive. 
* Go to **List Growth > Integrations**.
* Click on **Add New**.
* Select the first option and click on **Add New**.

<img src="https://mintcdn.com/emotiv/sgYvST6NOqMHyLcF/images/integrations/klaviyo-add-new-api.png?fit=max&auto=format&n=sgYvST6NOqMHyLcF&q=85&s=a285881ac4b691810480a442babbf0d7" alt="screenshot showing how to create a new list growth api in emotive" height="200" className="integrations" data-path="images/integrations/klaviyo-add-new-api.png" />

* Name your integration.
* Select the Welcome Flow in Emotive you want to be sent out when people subscribe. You can select this under the *Welcome Message* settings.
* **Save** your changes.

<img src="https://mintcdn.com/emotiv/UVHcJMThQukP3aOq/images/integrations/klaviyo-save-api-key.png?fit=max&auto=format&n=UVHcJMThQukP3aOq&q=85&s=48613efa90735a5dab73384cc2646d4d" alt="screenshot showing how to save a new list growth api in emotive" height="200" className="integrations" data-path="images/integrations/klaviyo-save-api-key.png" />

Once this is complete, you’ll have the information needed for Klaviyo to sync your subscribers to Emotive. 

<img src="https://mintcdn.com/emotiv/UVHcJMThQukP3aOq/images/integrations/klaviyo-api-information.png?fit=max&auto=format&n=UVHcJMThQukP3aOq&q=85&s=b10c31d7d0583443a605eb8f77e275d3" alt="screenshot showing where to locate a new List Growth API and its information in Emotive" height="200" className="integrations" data-path="images/integrations/klaviyo-api-information.png" />

### Create a Flow in Klaviyo

* Navigate to **Flows**.
* Select **Create flow**.
* Select **Build your own**.
* Under your *Trigger*, select the same list you used in the phone collection step of your flow under your *Added to List* setting.
* Add the following Profile Filters:
  * emotive\_source is "true"
  * emotive\_sms is "true"

<img src="https://mintcdn.com/emotiv/sgYvST6NOqMHyLcF/images/integrations/emotive-klaviyo-flow-profile-filters.png?fit=max&auto=format&n=sgYvST6NOqMHyLcF&q=85&s=33dc1034be23d51114fcfa7c6f8f7e92" alt="screenshot displaying klaviyo trigger and profile filters from within the Klaviyo platform" height="200" className="integrations" data-path="images/integrations/emotive-klaviyo-flow-profile-filters.png" />

* Add the following **Webhook** to send data to Emotive.
* Enter the following *Destination URL* = [**https://api-gw.emotiveapp.co/sensus-webhook/v1/subscriber**](https://api-gw.emotiveapp.co/sensus-webhook/v1/subscriber)
* Add the following *Header*:
  * Key = "Authorization"
  * Value = "Token api\_key"

<img src="https://mintcdn.com/emotiv/sgYvST6NOqMHyLcF/images/integrations/emotive-klaviyo-webhook-details.png?fit=max&auto=format&n=sgYvST6NOqMHyLcF&q=85&s=c9cef288115b4623fb761a22e49936dd" alt="screenshot showing klaviyo and Emotive webhook details in the Klaviyo Flow builder" height="200" className="integrations" data-path="images/integrations/emotive-klaviyo-webhook-details.png" />

<Tip>
  The API Key is associated with your List Growth Signup Flow in Emotive. This can be found in[<u>List Growth > Integrations.</u>](https://www.emotiveapp.co/list-growth/tools)
</Tip>

* Type in your payload in JSON body replacing the “list\_id” for the one found in Emotive:

```
{
"email": "{{ person.email }}",
"phone_number": "{{ person.phone_number|default:'' }}",
"subscribe_identifier": "{{list_id}}"
}
```

<Tip>
  The list id is associated with your List Growth Signup Flow in Emotive. This can be found in[<u>List Growth > Integrations.</u>](https://www.emotiveapp.co/list-growth/tools)  Make sure to paste it into Klaviyo between quotation marks “” without any spaces.
</Tip>

<img src="https://mintcdn.com/emotiv/sgYvST6NOqMHyLcF/images/integrations/emotive-klaviyo-json-body.png?fit=max&auto=format&n=sgYvST6NOqMHyLcF&q=85&s=7529d2934fbb1b8a3e39a106520830bb" alt="screenshot showing an example of a subscriber identifier in json raw body" height="200" className="integrations" data-path="images/integrations/emotive-klaviyo-json-body.png" />

* Click **Save** and Activate your Flow so that it is live.

Once this is complete, your signups will now sync to your Emotive account and enter your Signup Flow.

## FAQs

<AccordionGroup>
  <Accordion icon="circle-question" title="I've selected a Klaviyo list/segment to sync, now what?">
    After you select a Klaviyo List to sync, we'll automatically create an Emotive segment on the [Segments](https://www.emotiveapp.co/segments/) page under *Third-Party Segments*.
  </Accordion>

  <Accordion icon="circle-question" title="How often do segments automatically sync?">
    They typically sync every hour, but it could take up to four hours for larger lists. Our sync starts immediately after selecting a list from the integrations page. Our syncs happen at the top of the hour.
  </Accordion>

  <Accordion icon="circle-question" title="Can I still manually refresh in addition to the automatic refresh?">
    Currently, it is not possible to manually sync a list.
  </Accordion>

  <Accordion icon="circle-question" title="How many lists can we sync?">
    We have no limits to the number of lists you would like to sync.
  </Accordion>

  <Accordion icon="circle-question" title="Is there a segment list size limit?">
    No, although larger list sizes will take longer to sync with Emotive.
  </Accordion>

  <Accordion icon="circle-question" title="How does the sync work?">
    We scan a Klaviyo list and extract all profiles that include a phone number. We then look at your customer list in Emotive and create a list of customers that are in both systems. This list will be available as segment logic to be used in Broadcasts and Sequences.
  </Accordion>

  <Accordion icon="circle-question" title="Why do you only message customers that are matched in both systems?">
    Due to the state of SMS marketing from a legal perspective we need to be very careful who we message for legal compliance with [**TCPA**](https://www.fcc.gov/tags/telephone-consumer-protection-act-tcpa). We will only message customers that have opted-in properly via Emotive to reduce liability exposure for your brand.
  </Accordion>

  <Accordion icon="circle-question" title="How do I increase the match rate between Emotive and Klaviyo?">
    There are a few suggestions here. First, make sure that Klaviyo is integrated with your e-commerce platform so that customers that have consented to SMS marketing are added to both Emotive and Klaviyo. Second, if you already have a list of customers in Klaviyo that have phone numbers and have consented to marketing we can import them into Emotive.
  </Accordion>

  <Accordion icon="circle-question" title="Can Emotive sync Klaviyo segments and lists?">
    Yes, Emotive will make both Klaviyo segments and lists available to sync.
  </Accordion>
</AccordionGroup>
