About the AIQ <> Klaviyo Integration
Sync your Klaviyo contacts to AIQ and take advantage of our data analytics and marketing features. Read on below to see how to connect your account and begin pushing contacts back and forth.
For both connection options, you will need to grab your Private API Key from your Klaviyo account, if you need help locating where to find it check out the article here.
How To Connect Klaviyo as a Source
Use this option if you would like to pull in contacts:
Navigate to Settings > Integrations > Klaviyo. Find the Klaviyo integration that says "Data Source"
Click Connect
Paste in your Private API Key from your Klaviyo Account into the API Key field
Check the toggle next to "All users are age compliant with my industry?"
Enter the segment/list names or IDs from which you would like to import 'opted in' shoppers.
(Optional) Enter any segment/list names or IDs from which you would like to import 'opted out' shoppers (also known as a blocklist).
(Optional) Attributes: Enter a custom mapping of Klaviyo attributes to AIQ. If no custom mapping is entered, only the email, phone number, and ID will be imported for each contact.
Other optional settings:
Send SMS double-optins to Personas who purchased after X date: Use this to trigger and opt-in message to be sent for any new number
Enroll personas in loyalty program who purchased after X date: Forces all shoppers sourced from Klaviyo to be enrolled into loyalty
Use AIQ's last backup of this sources data: Turn this on to freeze your data from this source from the last audience run and discontinue hitting the sources API for new data.
⚠️ Only use this if you are switching systems and want to preserve your data.
Click Save
How To Connect Klaviyo as a Destination
Use this option if you would like to push out new contacts:
For Owner level users, navigate to Settings -> Integrations and then use the search bar to locate the Klaviyo integration. Then select "Connect" to open Integration Card Input fields.
Paste in your Private API Key from your Klaviyo account into the API Key field
(Optional) Enter any segment/list names or IDs from which you would like to import 'opted out' shoppers (also known as a blacklist)
Click the purple Connect button in the top right to save your key and you are now connected!
How To Send A Specific List Of Shoppers
Head to Audiences and filter using the traits you want
Click the Klaviyo checkbox at the bottom near Data
Save your Audience
FAQs
How Do I Use Custom Traits?
Custom attributes that you enable using the custom mapping above can be used in the audience builder under "Custom brand traits". Note that custom attributes won't populate here until after we've pulled them on contacts from Klaivyo.
How often do you sync data between platforms?
As a data source we pull every 4-6 hours, as a data destination we push every 24 hours.
How often to audiences get pushed to Klaviyo?
Every 3 hours.
Can I send data from AIQ to Klaviyo to create triggers for flows (including lifecycle messages)?
No, we don't currently utilize any Klaviyo triggering functionality. We only export audience lists to klaviyo as lists on their end..with phone, email etc for each Persona
Troubleshooting: Lists Not Pulling Into AIQ After Setup
If contacts from Klaviyo are not appearing in AIQ after setup, check these two common causes:
API key permissions: The Klaviyo private API key must have read access to Lists, Segments, and Profiles. A key created without these scopes will silently fail to sync — no error message is shown. Regenerate the key in Klaviyo with the correct scopes and re-enter it in AIQ.
IDs, not display names: The List/Segment IDs field must contain Klaviyo's short alphanumeric IDs (found in each list or segment's settings page in Klaviyo), not display names. Entering a name instead of the ID causes the sync to silently skip that list entirely.
Which contacts get sent to Klaviyo when AIQ pushes to it as a destination?
AIQ applies the following filters before sending contacts to Klaviyo. A contact must meet all of these requirements to be included in the export:
Valid contact info: The contact must have a usable identifier (phone or email).
Opted-in status: The contact must be opted in to marketing.
New contacts only: AIQ only sends contacts that have not already been exported to Klaviyo in a previous sync.
Valid email address: A valid email is required regardless of other opt-in status.
⚠️ Contacts opted into SMS only (with no email address) are NOT sent to Klaviyo. Because Klaviyo is an email-first platform, a valid email address is required for every exported contact — even if the merchant's campaign targeting uses phone numbers. If you expect a contact to appear in Klaviyo and they don't, confirm they have a valid email on their AIQ persona.
Need Help?
If you need assistance, reach out to AIQ Support anytime via chat widget within your AIQ Dashboard.