Klaviyo

  Text

Connect Attentive and Klaviyo to automatically send email subscribers captured through Attentive sign-up units into Klaviyo. You can customize the destination list and source tracking per sign-up unit, sync additional data to bolster Klaviyo profiles, keep subscription statuses aligned between Attentive and Klaviyo, and sync subscriber segments from Klaviyo to Attentive.

Prerequisites

You must have a Klaviyo account in order to set up this integration

Step 1. Generate a private API key in Klaviyo

Log in to your Klaviyo account and generate a new private API key.

Note: When choosing the scope that you want to give the API key, select Full Access Key. See How to create a private API key from Klaviyo for more information.

Step 2. Set up the Klaviyo integration in Attentive

  1. Go to Marketplace and click Klaviyo.
  2. Click Install.
  3. Enter the private API Key that you generated in Step 1.
  4. Click Save and continue.
  5. In the dropdown, select the Klaviyo list that you want to push new subscribers to.
  6. Click Save and continue.
  7. Click Save changes.

Your Klaviyo account is now connected to Attentive. For optimal performance, be sure to complete Step 3 below.

For more about what information is sent to Klaviyo from Attentive by default, see Reference: default custom profile properties.

Advanced customization options are also available. See Configure optional settings below for more information.

Step 3. Add a link tracking parameter to Klaviyo links

Finally, add klaviyo_id as a link tracking parameter to the links in your Klaviyo emails. This allows Attentive to better identify your email subscribers when they browse your site, which increases the volume of messages you can send.

Configure optional settings

Sign-up unit list management

This setting allows you to send email addresses collected from a selected sign-up unit to a specific list in Klaviyo.

Example: Send email addresses collected from a BFCM-specific sign-up unit to a Klaviyo list of email addresses collected during BFCM.

To send email addresses to a specific list in Klaviyo:

  1. Go to the Settings tab for the Klaviyo integration in the Attentive Marketplace.
  2. Under Optional settings, click Sign-up unit list management.
  3. Click + Add new.
  4. From the dropdown in the List column, select a Klaviyo list.
  5. Click the three dots in the Sign-up unit column, then click Edit. The Choose sign-up units window appears.
  6. Check the box for each Attentive sign-up unit from which you want to send email addresses to your selected Klaviyo list.
  7. Click Add sign-up unit. The Choose sign-up units window closes.
  8. Click Save changes.

Animation showing a user following the steps to send email addresses collected from a selected sign-up
  unit to a specific list in Klaviyo

Now, when visitors enter their email addresses into one of the sign-up units you selected, their email addresses will be added to the Klaviyo list you selected.

Sign-up unit source management

This setting allows you to change the value of the $source custom profile property sent to Klaviyo. The default value is attentive.

Example: Send source=attentive_bfcm for email addresses collected from a BFCM-specific sign-up unit.

To change the value of the $source property:

  1. Go to the Settings tab for the Klaviyo integration in the Attentive Marketplace.
  2. Under Optional settings, click Sign-up unit source management.
  3. Click + Add new.
  4. Enter a value in the field under the Source column (e.g, attentive_bfcm).
  5. Click the three dots in the Sign-up unit column, then click Edit. The Choose sign-up units window appears.
  6. Check the box for each Attentive sign-up unit you want to associate with the new Source value.
  7. Click Add sign-up unit. The Choose sign-up units window closes.
  8. Click Save changes.

Animation showing a user changing the value of the source custom profile property sent to Klaviyo.

Now, when subscribers sign up through one of the associated sign-up units, your chosen Source value will be passed to Klaviyo.

Pass additional attributes to Klaviyo

This setting allows you to send subscribers’ custom attribute data to Klaviyo.

Example: Your Attentive sign-up units use a custom attribute to ask what kinds of products subscribers are interested in (mens_shoes, womens_shoes, kids_shoes). You can send this custom attribute data to Klaviyo so that you can use it to create targeted segments or campaigns based on product interest.

To send subscribers’ custom attribute data to Klaviyo:

  1. Go to the Settings tab for the Klaviyo integration in the Attentive Marketplace.
  2. Under Optional settings, click Pass additional attributes to Klaviyo.
  3. Check Sync additional attributes to Klaviyo.
  4. Use the search bar to search for and select any custom attributes with data you want to send to Klaviyo.
  5. Click Save changes.

Animation showing a user sending subscribers custom attribute data to Klaviyo.

Now, when subscribers sign up through an Attentive sign-up unit, Attentive sends data from your selected custom attributes to Klaviyo.

Sync additional data to Klaviyo

This setting allows you to send additional Attentive subscriber data, like coupon/offer codes and phone numbers. You can also send values for custom properties in Klaviyo.

Notes:
  • To send subscriber phone numbers to Klaviyo, reach out to your Attentive CSM or contact Support here.
  • You can post discount codes from Attentive profiles to corresponding Klaviyo profiles. However, it’s not currently possible to post discount codes from Klaviyo profiles to corresponding Attentive profiles.
Example: Subscribers are assigned a unique offer code when they opt in to receive marketing emails and SMS from Attentive. You can send subscribers’ unique offer codes to Klaviyo so they can be included in personalized emails you send from Klaviyo.

To send additional Attentive subscriber data to Klaviyo:

  1. Go to the Settings tab for the Klaviyo integration in the Attentive Marketplace.
  2. Under Optional settings, click Sync additional data to Klaviyo.
  3. To send coupon/offer code values to Klaviyo, check Coupon.
  4. To send additional properties, check Add additional properties, then click + Add additional property. The Add property window opens.
  5. In the Add property window:
    • Enter the Klaviyo property name. This should match the name of a custom property you’ve already set up in Klaviyo.

      Example: You want to send the ID of the Attentive sign-up unit a subscriber signed up through. You have a custom property in Klaviyo called Attentive creative ID, so you enter that as the Klaviyo property name.
    • Enter the Attentive value. You can enter freeform text or you can click { } to see a list of available Attentive values from which you can copy & paste.

      Example: To send the ID of the Attentive sign-up unit a subscriber signed up through, enter the corresponding Attentive value: ${CREATIVE_ID}.
    • Click Submit.
  6. Click Save changes.

Animation showing a user sending additional Attentive subscriber data, like an offer code and values for custom properties in Klaviyo.

Now, when subscribers sign up through an Attentive sign-up unit, Attentive sends this additional data to Klaviyo along with the default attribute data and any custom attribute data.

Create Segments

See Manage Klaviyo segments and FAQs: Klaviyo segments for more information about using Klaviyo segments in Attentive.

Sync email lists from Klaviyo

This setting allows you to automatically sync opt-ins and opt-outs between your Attentive and Klaviyo email lists.

Notes:
  • If you send email from both Attentive and Klaviyo, opt-out syncing is automatically enabled.
  • List-specific opt-in syncing from Klaviyo to Attentive is only available to brands who use Attentive in the US and don’t plan to launch Attentive in other countries.

To sync opt-ins and opt-outs between your Attentive and Klaviyo email lists:

  1. Go to the Settings tab for the Klaviyo integration in the Attentive Marketplace.
  2. Under Optional settings, click Sync email lists from Klaviyo.
  3. Check Sync email lists from Klaviyo.
  4. Use the search bar to search for and select Klaviyo lists you want to sync.
  5. Click Save changes.

The 'Sync email lists from Klaviyo' option checked, 'VIP' entered in the search bar, and the 'VIP' list selected.

Notes on syncing Attentive and Klaviyo email lists

If syncing is enabled between Attentive and Klaviyo, keep in mind that Attentive and Klaviyo manage email subscription statuses differently:

  • In Attentive, subscribers are added to a global email subscription list. They’re either subscribed to all marketing emails or none at all.
  • In Klaviyo, subscribers are added to individual lists and to a global email subscription list.

Because Attentive and Klaviyo manage subscriptions differently, the integration handles syncing between the two differently:

  • If someone opts out of a Klaviyo email list selected in Attentive, the integration opts them out of your Attentive email marketing list.
  • If someone opts out of the global Klaviyo email marketing list, the integration opts them out of your Attentive email marketing list.
  • If someone opts out of your Attentive email marketing list, the integration opts them out of all Klaviyo email marketing lists.
  • If someone opts in to a Klaviyo email list selected in Attentive, the integration opts them into your Attentive email marketing list.
  • If someone opts in to your Attentive email marketing list, the integration opts them into the Klaviyo email list selected in Attentive.
  • If someone is suppressed in Klaviyo, the integration opts them out of your Attentive email marketing list. Opting them back in requires support from Attentive.

Opt-ins and opt-outs from Attentive to Klaviyo happen in real time. Opt-ins and opt-outs from Klaviyo to Attentive aren’t real-time, but they do happen at least every eight hours.

Opt-in sync for customers using international email isn’t currently supported.

Reference: default custom profile properties

When contacts are added to Klaviyo from Attentive, they include the default custom profile properties described in the table below.

If you checked Pass additional attributes to Klaviyo in Step 2, the attributes that are collected through your onsite sign-up unit are also sent back to your Klaviyo account.

Klaviyo property Sample value Description
creativeID 123456 This property indicates the numeric value of the Attentive sign-up source where email/phone is captured.
smsTimeStamp 2019-02-05 19:30:28+00:00 This property indicates the time the contact signed up for SMS (sent in UTC format).
sms_attentive_signup TRUE This property indicates that the contact signed up for your SMS program via Attentive.
timeStamp 2019-02-05 19:30:28+00:00 This property indicates the time the contact signed up for emails (sent in UTC format).
url https://www.test.com/the-colorblock-textured-mini-box-bag/M0015799.html This contains the referring URL where the user consented to marketing services.
$source {customValue} This property indicates a customer provided value (example: attentive integration). It defaults to attentive if no custom value is entered.

Reference: Legacy Klaviyo APIs

On June 14, 2024, we successfully completed the migration to Klaviyo’s new API’s. No action is needed on your part—any Klaviyo API that’s leveraged in your Attentive-Klaviyo integration calls the new APIs.

If you received communication from Klaviyo asking you to make sure legacy APIs are no longer being leveraged in your Attentive program—or if you're interested in auditing your API usage in Klaviyo— review the table below to confirm which specific endpoints have been migrated.

Note: Some Klaviyo endpoints aren't relevant to the Attentive-Klaviyo integration, so they have not been migrated.
Klaviyo Legacy Endpoint Has Attentive migrated this endpoint?
/api/v1/metrics No, not used in the Attentive-Klaviyo Integration
/api/v1/metrics/timeline No, not used in the Attentive-Klaviyo Integration
/api/v1/metric/{metric_id}/

timeline

No, not used in the Attentive-Klaviyo Integration
/api/v1/metric/{metric_id}/

export

No, not used in the Attentive-Klaviyo Integration
/api/track Yes
/api/identify Yes
/ajax/subscriptions Yes
/api/v1/people/exclusions Yes
/api/v2/list/{list_id}/

exclusions/all

Yes
/api/v2/people/search Yes
/api/v2/people/exchange Yes
/api/v1/person/{person_id} Yes
/api/v1/person/{person_id}/

metric/{metric_id}/timeline

Yes
/api/v2/group/

{list_or_segment_id}/

members/all

Yes
/api/v2/list/{list_id}/

subscribe

Yes
/api/v2/lists Yes
/api/v2/list/{list_id}/

members

Yes
/api/v1/email-templates Yes
/api/v1/email-template/

{template_id}/clone

Yes
/api/v1/email-template/

{template_id}/render

Yes
/api/v2/data-privacy/

deletion-request

Yes
/api/v1/campaigns Yes
/api/v1/campaign/

{campaign_id}/send

Yes
/api/v1/campaign/

{campaign_id}/schedule

Yes
/api/v1/campaign/

{campaign_id}/cancel

Yes
/api/v1/campaign/

{campaign_id}/clone

Yes
/api/v1/campaign/

{campaign_id}/recipients

Yes
/api/v1/campaign/

{campaign_id}

Yes

Questions?

We’re here to help! Contact our Support team here to ask about the Attentive + Klaviyo integration.

Articles in this section

Was this article helpful?
2 out of 4 found this helpful