Klaviyo Integration

Fluentos connects to Klaviyo using OAuth for secure, token-based authentication. No API keys are required from your side — simply click Authenticate with Klaviyo and authorize the connection.

How it works

When you connect Klaviyo, Fluentos requests the following permissions on your Klaviyo account:

Permission	Purpose
profiles:read	Read visitor profiles for audience targeting and personalization
profiles:write	Create or update profiles from form submissions
subscriptions:read	Check subscription status
subscriptions:write	Subscribe profiles to email marketing
lists:read	Fetch available lists for mapping
lists:write	Add submitted profiles to selected lists
segments:read	Read segments for audience targeting rules

Setup

1. Navigate to Integrations in your Fluentos workspace.
2. Click Add Integration.
3. Select Klaviyo from the provider list.
4. Give the integration a name (e.g. “Klaviyo Production”).
5. Click Authenticate with Klaviyo.
6. A popup opens — log in to your Klaviyo account if needed and click Allow to grant permissions.
7. The popup closes and the integration shows as Connected.
8. Optionally enable Audience Targeting to personalize campaigns based on Klaviyo segments.
9. Click Save.

Audience Targeting

When enabled, Fluentos identifies visitors arriving from Klaviyo email links (via the _kx URL parameter) and checks which Klaviyo segments they belong to. This allows you to:

• Show or hide campaigns based on segment membership.
• Personalize campaign content using visitor profile data (email, first name) stored in DataHub.

Configuration

• URL Parameter (default: _kx) — the query parameter Klaviyo appends to email links.
• Cookie Name (default: _klyv_id) — stores the visitor identifier for return visits.

DataHub fields

Selected profile fields from Klaviyo are stored in Fluentos DataHub for use in campaign personalization:

Field	DataHub key	Description
Profile ID	{{dataHub:klaviyo-profileId}}	Always stored. Required for visitor identification.
Email	{{dataHub:klaviyo-email}}	Optional. Visitor’s email address.
First Name	{{dataHub:klaviyo-firstName}}	Optional. Visitor’s first name.

Disconnect

To disconnect the Klaviyo integration:

1. Open the integration in edit mode.
2. Click the Disconnect button.
3. This revokes all access tokens and removes the connection on both the Fluentos and Klaviyo side.

You can re-authenticate at any time by clicking Authenticate with Klaviyo again.

Troubleshooting

Issue	Solution
Authentication popup doesn’t open	Check if your browser is blocking popups for the Fluentos dashboard.
”Integration not valid” error	The OAuth session may have expired. Click Authenticate with Klaviyo to reconnect.
Audience targeting not working	Ensure your Klaviyo email links include the _kx parameter and that your campaigns are published.
Failed submissions	Check the error count in integration settings. Click Process failing entries to retry.