Linking GoCardless as a source
This source is currently in alpha. The interface and available tables may change.
The GoCardless connector syncs your bank debit payments data into PostHog, including customers, mandates, payments, subscriptions, payouts, refunds, and events.
Linking GoCardless
Go to the sources tab of the data pipeline section in PostHog.
Click + New source and then click Link next to GoCardless.
Select your Environment — either Live or Sandbox. Sandbox and live environments use separate API hosts and tokens, so make sure the environment matches your token.
You need an access token from GoCardless. In your GoCardless dashboard, go to Developers > Create > Access token. Copy the token value.
Back in PostHog, paste your access token into the Access token field.
Click Next.
Select the schemas you want to sync and configure the sync method and frequency. Click Import.
Once the syncs are complete, you can start using GoCardless data in PostHog.
Available tables
| Table | Description | Sync mode |
|---|---|---|
| customers | Customer records | Full refresh |
| mandates | Bank mandate authorizations | Full refresh |
| payments | Payment transactions | Full refresh |
| subscriptions | Recurring payment subscriptions | Full refresh |
| payouts | Payouts to your bank account | Full refresh |
| refunds | Refund records | Full refresh |
| events | Change log of all GoCardless events | Incremental |
Sync modes
Only the events table supports incremental syncing. All other tables use full refresh.
This is because the GoCardless API only supports filtering on created_at — there's no updated_at filter. Since core records like payments, mandates, and subscriptions mutate their status over time, an incremental sync based on created_at alone would miss those changes.
The events table is GoCardless's append-only change log, making it the only table where incremental sync reliably captures all data. This is the same pattern used by other GoCardless connectors like Fivetran.
Configuration
| Option | Type | Required |
|---|---|---|
Environment | select | Yes |
Access token | password | Yes |