How do I set up the Klaviyo integration with Recurly Commerce?

The Klaviyo integration allows you to sync real-time subscription events and customer properties from Recurly Commerce into Klaviyo—unlocking advanced segmentation and event-based flows.

Before you begin

• You must have an active Klaviyo account

• The Recurly Commerce Klaviyo integration must be enabled in your merchant admin

• Historical customer properties will backfill, but only new events after integration will trigger Klaviyo metrics

What does the integration include?

Recurly Commerce sends real-time subscription events and customer-level data into Klaviyo, enabling powerful, personalized email flows.

Why use it?

• Trigger flows from subscription events like start, pause, or billing failure

• Segment customers based on status (active, cancelled, paused, etc.)

• Embed self-service quick actions like “skip next” or “reactivate” directly in your emails

Events sent to Klaviyo

• Prive Subscription Started – When a new subscription is created

• Prive Subscription Cancelled – When cancelled by merchant or customer

• Prive Subscription Paused – When paused by merchant or customer

• Prive Status Update – When subscription status changes

• Prive Billing Attempt Failed – When a billing attempt fails

• Prive Upcoming Order – Triggers 3 days before renewal

• Prive Gift Confirmation – When a gift subscription is created

• Prive Out of Stock – When a product is deleted or sold out

• Prive Order Placed – When a renewal order is processed

Event properties

Each event includes details such as:

• charge_amount

• product_title and variant_id

• next_billing_date

• order_interval_frequency and unit

• is_prepaid

• cancel_reason

• total_retries

• order_number

Use these to build precise Klaviyo segments like “All paused subscribers with billing failures in the last 7 days.”

Customer properties in Klaviyo

Recurly Commerce also writes properties to each customer profile:

• prive_is_active_subscriber – Boolean

• prive_active_subscription_count – Number

• prive_status_cancelled_subscriptions – Number

• prive_status_paused_subscriptions – Number

• prive_status_skipped_subscriptions – Number

Using Quick Actions in Klaviyo emails

1. Create a quicklink in your Prive merchant admin

2. Wait for an event to fire (like “Upcoming Order”)

3. The link will appear in the customer’s Klaviyo profile

4. Use the variable in your Klaviyo flow:
   {{ event.extra.quicklink_name }}

5. When clicked, the action executes and shows a confirmation message

Data backfill

• Customer properties will backfill for all existing subscribers

• Events will only trigger for new actions going forward

Local testing

To test Klaviyo events in a local dev environment:

1. Request access to your Klaviyo test account

2. Copy account data from production and update the expires_at timestamp

3. Set your local merchantId

4. Trigger subscription events—they will sync to the test Klaviyo account

For more details, visit our Recurly Commerce Product Documentation.