Linking Recurly as a source
The Recurly connector syncs your subscription billing data into PostHog, including accounts, subscriptions, invoices, transactions, and more.
To link Recurly:
Go to the sources tab of the data pipeline section in PostHog.
Click + New source and then click Link next to Recurly.
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.
Back in PostHog, paste the API key in the
API keyfield.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.Click Next.
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 | — |
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_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. | Incremental, Full refresh | updated_at, created_at | — |
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 | — |