> AI agents: this is one page from PostHog's docs. Full index of Markdown docs for LLMs: https://posthog.com/llms.txt

# Linking Recurly as a source

Canonical URL: https://posthog.com/docs/data-pipelines/sources/recurly

> **Cloud region:** This page uses US Cloud hosts. For an EU Cloud project, use `https://eu.posthog.com` instead of `https://app.posthog.com` (app host for links).

![](https://res.cloudinary.com/dmukukwp6/image/upload/texture_tan_9608fcca70)

![](https://res.cloudinary.com/dmukukwp6/image/upload/texture_tan_dark_a92b0e022d)

Let AI connect your sources for you

Skip the manual setup — run this in your project and the wizard auto-detects your databases and APIs and connects them to PostHog.

`npx @posthog/wizard warehouse`

![PostHog Wizard hedgehog](https://res.cloudinary.com/dmukukwp6/image/upload/wizard_3f8bb7a240.png)

![](https://res.cloudinary.com/dmukukwp6/image/upload/wizard_3f8bb7a240.png)Let AI connect your sources for you

The Recurly connector syncs your subscription billing data into PostHog, including accounts, subscriptions, invoices, transactions, and more.

To link Recurly:

1.  Go to the [sources tab](https://app.posthog.com/data-management/sources) of the data pipeline section in PostHog.

2.  Click **\+ New source** and then click **Link** next to Recurly.

3.  You need a private API key from Recurly. In your Recurly dashboard, go to **Integrations** > **API Credentials** and create a new private API key. Copy the key value.

4.  Back in PostHog, paste the API key in the `API key` field.

5.  Select the **Region** that matches your Recurly site — either **US** (`v3.recurly.com`) or **EU** (`v3.eu.recurly.com`). The region must match where your Recurly site is hosted.

6.  Click **Next**.

7.  On the next page, set up the schemas you want to sync and modify the method and frequency as needed. Once done, click **Import**.

Once the syncs are complete, you can start using Recurly data in PostHog.

## Configuration

| Option | Type | Required |
| --- | --- | --- |
| `API key` | password | Yes |
| `Region` | select | Yes |

## Supported tables

| Table | Description | Sync method | Incremental field | Primary key |
| --- | --- | --- | --- | --- |
| `accounts` | A customer account that holds subscriptions, invoices, and billing information. | Incremental, Full refresh | updated\_at, created\_at | — |
| `acquisitions` | Acquisition (marketing attribution) data describing how an account was acquired. | Incremental, Full refresh | updated\_at, created\_at | — |
| `add_ons` | An add-on that can be attached to a subscription on top of its base plan. | Incremental, Full refresh | updated\_at, created\_at | — |
| `business_entities` | A business entity whose address Recurly uses on invoices and for tax calculation, depending on subscriber location. | Full refresh | — | — |
| `coupon_redemptions` | A coupon applied to an account or subscription, used to track promotions. | Full refresh | — | — |
| `coupons` | A discount coupon that can be redeemed against subscriptions or invoices. | Incremental, Full refresh | updated\_at, created\_at | — |
| `credit_payments` | A payment made using account credit rather than an external payment method. | Incremental, Full refresh | updated\_at, created\_at | — |
| `dunning_campaigns` | A dunning campaign defining the schedule of retries and notices for failed payments. | Full refresh | — | — |
| `external_invoices` | An invoice from a third-party platform such as the Apple App Store or Google Play Store. | Full refresh | — | — |
| `external_subscriptions` | A subscription managed outside Recurly (e.g. through Apple App Store or Google Play). | Full refresh | — | — |
| `gift_cards` | A gift card that can be redeemed to credit an account's balance. | Full refresh | — | — |
| `invoices` | An invoice billing an account for subscriptions, charges, or one-time purchases. | Incremental, Full refresh | updated\_at, created\_at | — |
| `items` | A catalog item representing a product or service that can be sold. | Incremental, Full refresh | updated\_at, created\_at | — |
| `line_items` | A single charge or credit line on an invoice. | Incremental, Full refresh | updated\_at, created\_at | — |
| `measured_units` | A unit of measurement used for metering usage-based add-ons. | Incremental, Full refresh | updated\_at, created\_at | — |
| `plans` | A subscription plan defining recurring pricing and billing cadence. | Incremental, Full refresh | updated\_at, created\_at | — |
| `shipping_methods` | A shipping method available for physical goods, with carrier and cost details. | Incremental, Full refresh | updated\_at, created\_at | — |
| `subscriptions` | A recurring subscription linking an account to a plan with a billing schedule. | Incremental, Full refresh | updated\_at, created\_at | — |
| `transactions` | A payment transaction (charge, refund, or verification) against an account. | Incremental, Full refresh | updated\_at, created\_at | — |
| `usage` | A usage record logged on a usage-based subscription add-on and billed in arrears. | Full refresh | — | — |