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 extension supports an optional Klaviyo master list. When configured, every profile that is subscribed to email marketing is automatically added to that single Klaviyo list — regardless of how they originally subscribed. This is useful when you want a single, authoritative list of subscribed customers to use as the base for segmentation, exports, or campaign sends, without having to manually keep multiple sources of subscriptions in sync.

​
What changes when a master list is set

Configuring a master list affects the integration in three places:

​
1. New subscriptions from Omneo

Whenever Omneo tells Klaviyo to subscribe a profile to email marketing, the subscribe request is sent with the master list attached. The profile is added to the master list as part of the same call. This applies to:
  • New profile creation
  • Profile resyncs
  • Any Omneo update that flips the profile into a subscribed state
SMS-transactional-only subscriptions are excluded — those never affect the master list.

​
2. System webhook processing

When a Klaviyo system webhook results in the Omneo profile becoming subscribed (for example, subscribed_to_email_marketing, subscribed_to_list, or any combined update where the profile ends up subscribed), the extension:
  1. Updates the Omneo profile.
  2. Re-fetches the Klaviyo profile to check current subscription state.
  3. Checks whether the profile is already a member of the master list.
  4. If not, calls Klaviyo’s subscribe endpoint to add them — which also generates the standard Klaviyo events for list membership tracking.
This guarantees that profiles who subscribed through any channel — Klaviyo signup forms, the Klaviyo UI, the Klaviyo API, manual imports, or Omneo — all end up in the same master list without manual intervention.

​
3. Reconciliation on profile updates

On any profile sync where the profile is subscribed but missing from the master list, the extension forces a subscribe request to add them. This is a self-healing behaviour: if list membership ever drifts (e.g. someone was manually removed from the list in Klaviyo), the next profile update will put them back.

​
When the master list is not used

  • When the setting is empty (the default) — the integration behaves exactly as before, and list membership is left entirely up to Klaviyo.
  • When the profile is not subscribed to email marketing — opted-out, bounced, or never-subscribed profiles are never added to the master list.
  • For SMS-transactional-only flows — those bypass list assignment entirely.

​
Choosing the right list

The master list should be a list that:
  • Is dedicated to subscribed customers — not a static import list or a one-off campaign list.
  • You are comfortable having profiles added to automatically as soon as they opt in.
  • Is the starting point for the segments and campaigns where you want every subscribed customer to be eligible.
You can change the configured master list at any time. Existing profiles in the previously configured list are left untouched; new subscriptions will start flowing into the new list from the moment the setting is updated.