# Integrate with Klaviyo

> Talon.One supports integrating with Klaviyo using a dedicated integration in the Integration Hub.

> For the complete documentation index, see [llms.txt](https://docs.talon.one/llms.txt).

## Klaviyo integration features

The **Talon.One Klaviyo integration** in the [Integration
Hub](/docs/dev/integration-hub/overview.md) enables data synchronization between Klaviyo
and Talon.One.

By creating a bidirectional data flow, the integration allows you to do the following:

- Receive **customer profile IDs** from Klaviyo.
- Receive [segments and lists](https://help.klaviyo.com/hc/en-us/articles/115005061447)
  from Klaviyo and store them as [Talon.One
  audiences](/docs/product/audiences/overview.md).
- Generate [coupon codes](/docs/product/campaigns/coupons/create-coupons.md) in
  Talon.One and send them to Klaviyo.
- Send loyalty points and [tier
  information](/docs/product/loyalty-programs/profile-based/use-loyalty-tiers.md) from
  Talon.One to Klaviyo.

## Data flow

### From Klaviyo to Talon.One

- **Customer profile IDs**: The [profile
  sync](/docs/dev/technology-partners/klaviyo/set-up-klaviyo-integration.md#configure-the-profile-sync)
  matches customer profiles in Klaviyo against existing profiles in Talon.One. You
  can choose a Klaviyo profile identifier, for example, `external_id`, to match
  against the customer integration ID in Talon.One.

  For each match, a `KlaviyoId` custom attribute is added to the Talon.One customer
  profile. The attribute is then used, for example, to look up profiles in Klaviyo when
  sending loyalty data.

  :::note
   For the profile sync, the following rules apply:

  - If a Klaviyo customer profile does not exist in Talon.One, it is created.
  - If a Klaviyo customer profile already exists in Talon.One, it is updated with
    the information from Klaviyo. Specifically, the `KlaviyoId` custom attribute is
    populated with the corresponding Klaviyo ID.
  - If a customer profile exists in Talon.One, but not in Klaviyo, it is **not**
    created in Klaviyo.
  - If you delete a profile in Klaviyo, the corresponding customer profile in Talon.One
    is **not** deleted.
  :::
- **Segments and lists**: During the [audience
  sync](/docs/dev/technology-partners/klaviyo/set-up-klaviyo-integration.md#optional-configure-the-audience-sync),
  the lists and segments you select in Klaviyo are synced to Talon.One and created as
  [audiences](/docs/product/audiences/overview.md).

### From Talon.One to Klaviyo

- **Loyalty points and tier information**: If you configure the [loyalty
  sync](/docs/dev/technology-partners/klaviyo/set-up-klaviyo-integration.md#optional-configure-the-loyalty-sync),
  Talon.One updates the mapped [profile
  properties](https://help.klaviyo.com/hc/en-us/articles/115005074627) in Klaviyo. For
  example, if the loyalty balance of a customer changes in Talon.One, the corresponding
  profile property in Klaviyo is updated accordingly. Also, Talon.One sends a
  corresponding [Klaviyo
  event](https://developers.klaviyo.com/en/reference/events_api_overview) that can be used
  to trigger a flow in Klaviyo. Currently, the integration supports the following loyalty
  events:
  - `Points Changed`: Triggered when a customer's loyalty points balance changes, either
    by earning or redeeming points.
  - `Tier Upgrade`: Triggered when a customer reaches the next higher loyalty tier.
  - `Tier Downgrade`: Triggered when a customer drops to a lower loyalty tier.
- **Coupon codes**: Talon.One can generate coupon codes specifically for use in Klaviyo.
  There, you can use them, for example, to send [birthday
  coupons](/docs/dev/technology-partners/klaviyo/send-birthday-coupons-via-klaviyo.md) to
  your customers.

## Related pages

- [Set up the Klaviyo integration](/docs/dev/technology-partners/klaviyo/set-up-klaviyo-integration.md)
- [Send birthday coupons via Klaviyo](/docs/dev/technology-partners/klaviyo/send-birthday-coupons-via-klaviyo.md)
- [Send a tier upgrade email via Klaviyo](/docs/dev/technology-partners/klaviyo/send-tier-upgrade-email-via-klaviyo.md)
