Klaviyo

With this integration, you can pass email addresses collected through an Attentive sign-up unit to Klaviyo.

Prerequisites

Ensure that you meet the following requirements in order to set up this integration:

  • You must have a Klaviyo account

Now, complete the following procedures 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. (Optional) Pass additional attributes to Klaviyo beyond the default attributes default custom profile properties:
    • Check Pass additional attributes to Klaviyo.
    • Search for and select additional attribute(s).
  8. Click Save changes.

Your Klaviyo account is now connected to Attentive. See Manage Klaviyo segments for more information about using Klaviyo segments in Attentive.

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.

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.

To allow Attentive to post discount codes back to Klaviyo, you must set up a custom property in Klaviyo. This custom property allows Attentive to pass back the discount code assigned to a subscriber in an SMS journey to their corresponding Klaviyo profile. See Profile properties reference from Klaviyo for more information.

Note: 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.
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.

Sync email lists from Klaviyo

Attentive supports the ability 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.

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.

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.

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 API’s 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 White Glove team (whiteglove@attentivemobile.com) to ask about the Attentive + Klaviyo integration.

Articles in this section

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