Linking Paddle as a source
The Paddle connector syncs customers, discounts, prices, products, subscriptions, transactions, and adjustments from your Paddle account into PostHog.
Adding a data source
Go to the sources tab of the data pipeline section in PostHog.
Click + New source and then click Link next to Paddle.
Next, you need an API key from Paddle. In your Paddle dashboard, go to Developer tools > Authentication and click New API key. Give the key a name and grant it Read access to the following entities:
- Customers
- Discounts
- Prices
- Products
- Subscriptions
- Transactions
- Adjustments
Copy the generated API key (it starts with
pdl_live_...for live keys orpdl_sdbx_...for sandbox keys).Back in PostHog, paste the API key into the API Key field and click Next.
Select the tables 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 Paddle data in PostHog.
Configuration
| Option | Type | Required |
|---|---|---|
API Key | password | Yes |
Supported tables
| Table | Description | Sync method | Incremental field | Primary key |
|---|---|---|---|---|
customers | A customer who can hold subscriptions and be billed in Paddle. | Full refresh | — | — |
discounts | A discount (coupon) that reduces the amount charged on transactions or subscriptions. | Full refresh | — | — |
prices | A price for a product, including amount, billing cycle, and trial settings. | Full refresh | — | — |
products | A product or service you sell, which prices are attached to. | Full refresh | — | — |
subscriptions | A customer's recurring billing arrangement against one or more prices. | Full refresh | — | — |
transactions | A financial transaction — a payment, refund, or credit — for a customer. | Incremental, Full refresh | billed_at | — |
adjustments | A refund or credit applied to a transaction, reducing or returning charged amounts. | Full refresh | — | — |
Sync methods
Only the transactions table supports incremental and append-only syncing, using billed_at as the replication key. All other tables (customers, discounts, prices, products, subscriptions, and adjustments) are synced via full table refresh.