---
title: "How to integrate with Recurly"
description: "Learn how to integrate Recurly with Klaviyo in order to personalize and target emails based on invoice and payment data from your customers. Klaviyo syncs the following data from Recurly:"
canonical_url: "https://help.klaviyo.com/hc/en-us/articles/115005082207"
markdown_url: "https://help.klaviyo.com/hc/en-us/articles/115005082207.md"
locale: "en-us"
category: "Integrations"
section: "Recurly"
updated: "2026-10-29"
---

# How to integrate with Recurly

## You will learn

Learn how to integrate Recurly with Klaviyo in order to personalize and target emails based on invoice and payment data from your customers. Klaviyo syncs the following data from Recurly:

- When an invoice is issued, and the items included in each invoice

- Payment information for when a customer fails payment, is refunded, or successfully pays

- Profile properties associated with Recurly information



## Integrate Recurly with Klaviyo

You need permission to manage integrations in Klaviyo and developer or admin access in Recurly to retrieve your private API key.

1. To integrate Recurly with Klaviyo, you’ll need your Recurly API Key, so start by logging in to your Recurly account.

2. Navigate to **Integrations > API Credentials**.

3. Copy the Private API Key under **Default API Key** for use later.




![Default API Key section in Recurly with private API key blurred out](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/c0841d1ca32e6651a9e87a9b34e94971c12eea94-1668x454.jpg?auto=format)

**📝 Note:** Private API keys, such as your default key used here, should be treated like passwords; keep them in a safe place and never expose them to the public.

1. If your default API key is already in use with another third-party integration, you can generate a new private API key for the Klaviyo integration by clicking on **Add Private API Key**. 




![Private API Keys in Recurly showing Default API Key blurred out and Add Private API Key with gray background at the bottom](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/5c3158171eced03aff03deebcdba6f20ffe9f8db-1698x920.jpg?auto=format)

**📝 Note:** Recurly will only generate 5 private API keys to integrate with third-party applications.

1. If you created a new API key, copy it for use in your Klaviyo account.

2. In your Klaviyo account, select the **Integrations** tab.

3. Click **Explore apps** to open the app marketplace in a new tab. Search for **Recurly**, select its card, then click **Install**.

4. Enter your Recurly **Subdomain** and the **API key** you copied earlier, then click **Connect to Recurly**. For example, enter “yoursubdomain” for https://yoursubdomain.recurly.com.



![Image](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/a13b8ed2767023b34bc30ce1cc4948e17ef83f6a-1542x1060.png?auto=format)

5. If the integration is successful, a success message will appear and your historical data will start syncing. You can check sync progress on the **Data** tab of your Recurly integration.



## Monitor the Recurly sync

Klaviyo imports invoices and payments from the previous 1,825 days (about 5 years) when you connect Recurly. New invoices and payments sync about every 5 minutes. Invoices and payments for Recurly accounts without a valid email address are skipped.

1. In Klaviyo, click the **Analytics** dropdown and then select **Metrics**.

2. Search for **Issued Invoice** with the Recurly icon, click the metric name, then select the **Activity feed** tab.



![Page showing list of Issued Invoice via Recurly metrics in Klaviyo with timestamps](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/7db87fcbd683ad92b858dbbc9b11257420d25e58-1000x581.jpg?auto=format)

3. If your integration has started syncing data, you will start to see *Issued Invoice* events, with the Recurly icon, added to this activity feed.

4. To compare payment totals, return to **Analytics > Metrics** and open **Successfully Paid** with the Recurly icon.

5. On the **Chart** tab, choose a **Date range** that includes the day you want to check. Set **View by** to **Daily** and **Measurement** to **Total**.

6. Compare the total for that day with the number of successful payments in Recurly for the same date. Wait for the historical sync to finish before checking older dates.

7. If the totals differ, check that syncing has finished, that the payments have valid customer email addresses, and that your Klaviyo and Recurly accounts use the same time zone.

8. To check your timezone setting in Klaviyo:

   - Click your account name in the lower left corner.

   - Select **Settings**.

   - Select **Account**, then scroll down to **Time zone**.



## Data synced from Recurly to Klaviyo

### Metrics

Recurly syncs the following metrics to Klaviyo:

- **Failed Payment**
Recorded every time a payment made through Recurly is marked as failed.

- **Issued Invoice**
Recorded every time an invoice is issued to a customer through Recurly.

- **Ordered Product**
Recorded for items on an invoice when a customer makes a successful payment through Recurly. A payment can generate multiple Ordered Product events.

- **Refunded Payment**
Recorded when you refund a payment through Recurly.

- **Successfully Paid**
Recorded each time a customer successfully pays an invoice through Recurly.




![Metrics tab in Klaviyo filtered by Recurly with metrics such as Failed Payment and Issues Invoice](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/9c7829de22c9b6561e3a49f20262e87f4fd9ea8b-1676x590.jpg?auto=format)

### Profile properties

The following properties are synced from Recurly to Klaviyo profiles:

- Recurly Account Code

- Recurly Card Expiration Date

- Recurly Plan Codes

- Recurly Plans



**Recurly Plans** and **Recurly Plan Codes** are populated from active subscriptions when payment data syncs. **Recurly Card Expiration Date** is populated when billing details include an expiration month and year.

## Outcome

You’ve finished integrating Recurly with Klaviyo and have verified your synced data. Now, you can personalize and target emails based on invoice and payment data from your customers.

## Additional resources

- [Getting started with flows](https://help.klaviyo.com/hc/en-us/articles/115002774932.md)
  Learn how to use flows, also known as automations or drip campaigns, in Klaviyo for personalized and automated communications to your customers, and learn how to set your first flow live.
- [Getting started with segments](https://help.klaviyo.com/hc/en-us/articles/115005237908.md)
  Learn how to create and use segments in Klaviyo, which are a powerful tool for understanding your audience and sending targeted messages. 
- [Understanding the types of information exchanged between Klaviyo and apps](https://help.klaviyo.com/hc/en-us/articles/360030696012.md)
  Learn about what types of data are exchanged between Klaviyo and external apps, and where that data is found in your Klaviyo account. When you integrate a third-party application with Klaviyo, the two platforms exchange information. Most data exchange with Klaviyo is one-way; data is pulled into your Klaviyo account so you can leverage a broad scope of your customers' data within Klaviyo. 
