> ## 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.

# Installation

> Install the Omneo Klaviyo extension from the Klaviyo App Marketplace and review what is created on first install.

The Klaviyo extension is installed via the [Klaviyo App Marketplace](https://www.klaviyo.com/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

<Steps>
  <Step title="Find the Omneo app">
    Log in to Klaviyo and open the App Marketplace. Search for **Omneo** and select the listing.
  </Step>

  <Step title="Authorise the connection">
    Select **Install** and follow the OAuth prompts to grant Omneo access to your Klaviyo account. Klaviyo will redirect back to Omneo when authorisation completes.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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](/extensions/klaviyo/profile-sync) and [Master list](/extensions/klaviyo/master-list) pages.
  </Step>
</Steps>

<Tip>
  If you have already installed the extension previously, reinstalling is safe. Existing data sources and webhooks are detected and reused, so duplicates are not created.
</Tip>

## 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 source       | Purpose                                                             |
| ----------------- | ------------------------------------------------------------------- |
| Omneo Dates       | Customer date fields (birthdays, anniversaries, relationship dates) |
| Omneo Connections | External account links from Omneo profiles                          |
| Omneo Rewards     | Loyalty rewards activity and redemptions                            |
| Omneo Addresses   | Profile address changes                                             |
| Omneo Benefits    | Enrolments and activity for special programs                        |
| Omneo Lists       | List 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](/extensions/klaviyo/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](/extensions/klaviyo/queues).