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.
Step 2. Set up the Klaviyo integration in Attentive
- Go to Marketplace and click Klaviyo.
- Click Install.
- Enter the private API Key that you generated in Step 1.
- Click Save and continue.
- In the dropdown, select the Klaviyo list that you want to push new subscribers to.
- Click Save and continue.
- (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).
- 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.
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
|
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.
|
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.
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.