Linking Polar as a source
Contents
Connect your Polar.sh account to sync customers, products, orders, subscriptions, and more into the PostHog data warehouse.
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 Polar.
- Next, you need an Organization Access Token from Polar. Create one in your Polar account and grant it the following read scopes:
benefits:read,checkouts:read,customers:read,orders:read,organizations:read,products:read,refunds:read, andsubscriptions:read. Copy the token value (it starts withpolar_oat_). - Back in PostHog, enter the token in the
Organization Access Tokenfield and click Next. - Select the tables you want to sync, set the sync method and frequency, then click Import.
Once the syncs are complete, you can start using Polar data in PostHog.
Available tables
| Table | Description | Sync method |
|---|---|---|
customers | Customers in your Polar organization | Full refresh |
products | Products you sell on Polar | Full refresh |
orders | Orders placed through Polar | Full refresh |
subscriptions | Active and past subscriptions | Full refresh |
refunds | Refunds issued | Full refresh |
checkouts | Checkout sessions | Full refresh |
benefits | Benefits attached to your products | Full refresh |
organizations | Your Polar organizations | Full refresh |
Incremental tables sync only new or updated records on each run. Full refresh tables reload all data on each sync.
Configuration
| Option | Type | Required |
|---|---|---|
Organization Access Token | password | Yes |
Supported tables
| Table | Description | Sync method | Incremental field | Primary key |
|---|---|---|---|---|
customers | A customer of an organization who can purchase products and hold subscriptions. | Full refresh | — | — |
products | A product that can be purchased or subscribed to in Polar. | Full refresh | — | — |
orders | A completed purchase of a product, including one-time and subscription orders. | Full refresh | — | — |
subscriptions | A recurring subscription of a customer to a product. | Full refresh | — | — |
refunds | A refund issued against an order in Polar. | Full refresh | — | — |
checkouts | A checkout session for purchasing a product in Polar. | Full refresh | — | — |
benefits | A benefit that can be granted to customers through products in Polar. | Full refresh | — | — |
organizations | An organization on Polar that sells products and owns customers. | Full refresh | — | — |