Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.omneo.io/llms.txt

Use this file to discover all available pages before exploring further.

The Klaviyo extension is installed via the Klaviyo App Marketplace. Authorising the Omneo app from your Klaviyo account is enough to provision the integration — Omneo handles the rest of the setup for you.

​
Install from the Klaviyo Marketplace

1

Find the Omneo app

Log in to Klaviyo and open the App Marketplace. Search for Omneo and select the listing.
2

Authorise the connection

Click Install and follow the OAuth prompts to grant Omneo access to your Klaviyo account. Klaviyo will redirect back to Omneo when authorisation completes.
3

Confirm install in Omneo

The extension activates automatically against the Omneo tenant you authorised from. You can confirm installation status in the Extensions area of Omneo CX Manager.
4

Configure settings

Open the extension in CX Manager to configure mappings, the default region, the webhook secret, and (optionally) a Klaviyo master list. See the Profile sync and Master list pages.
If you have already installed the extension previously, reinstalling is safe. Existing data sources and webhooks are detected and reused — duplicates are not created.

​
What gets created on install

When the extension is installed, Omneo provisions resources on both sides of the integration.

​
In Klaviyo

Six data sources are created to organise customer activity records pushed from Omneo:
Data sourcePurpose
Omneo DatesCustomer date fields (birthdays, anniversaries, relationship dates)
Omneo ConnectionsExternal account links from Omneo profiles
Omneo RewardsLoyalty rewards activity and redemptions
Omneo AddressesProfile address changes
Omneo BenefitsEnrolments and activity for special programs
Omneo ListsList membership and subscription activity
System webhooks are registered in Klaviyo to listen for the bounce, subscribe, unsubscribe, and suppression events that need to flow back into Omneo. These webhooks are managed by Omneo and are not visible to end users in the Klaviyo UI. See System webhooks for the full list.

​
In Omneo

Three Omneo webhooks are created for syncing profile changes out to Klaviyo:
  • profile.created (disabled by default)
  • profile.updated (disabled by default)
  • profile.deleted (disabled by default)
These webhooks are created in a disabled state and must be manually enabled in CX Manager once you are ready for Omneo to start pushing profile changes to Klaviyo. Two Cloud Tasks queues are also provisioned for background processing — an inbound queue for work flowing from Klaviyo into Omneo, and an outbound queue for work flowing from Omneo to Klaviyo. See Inbound queues.