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

# Linking Mollie as a source

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

> **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).

## On this page

- [Adding a data source](#adding-a-data-source)
- [Sync mode](#sync-mode)
- [Authentication](#authentication)
- [Configuration](#configuration)
- [Supported tables](#supported-tables)

![](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 Mollie connector syncs your Mollie payments data into PostHog. The following tables are supported:

| Table | Description |
| --- | --- |
| payments | Payment transactions |
| refunds | Refund records |
| chargebacks | Chargeback records |
| customers | Customer records |
| subscriptions | Subscription records |
| settlements | Settlement records |
| payment\_links | Payment link records |
| balances | Balance accounts |
| balance\_transactions | Balance transaction records |
| profiles | Payment profile records |
| mandates | Customer mandate records |

## Adding a data source

1.  Go to the [Data pipeline page](https://app.posthog.com/data-management/sources) and the **Sources** tab in PostHog.
2.  Click **\+ New source** and select Mollie.
3.  Enter your Mollie API key. You can find this in the [Mollie dashboard](https://my.mollie.com/dashboard/developers/api-keys) under **Developers** > **API keys**. Use a live key (`live_...`) for production data — test keys only return test-mode data. To sync organization-level tables (balances, balance transactions, settlements, and profiles), use an [organization access token](https://docs.mollie.com/docs/authentication) (`access_...`) instead.
4.  Select the tables you want to sync.
5.  *Optional:* Add a prefix to your table names.
6.  Click **Next**.

The data warehouse then starts syncing your Mollie data. You can see details and progress in the [data pipeline sources tab](https://app.posthog.com/data-management/sources).

## Sync mode

Mollie only supports **full refresh** syncs. Incremental syncs aren't available because the Mollie v2 API doesn't support filtering by created or updated date, and mutable objects like payments, refunds, and chargebacks continue to change status after creation. A full refresh ensures you always have accurate, up-to-date data.

## Authentication

Most Mollie tables work with a regular API key (`live_...` or `test_...`). However, the following tables are organization-level resources that Mollie only serves to an [organization access token](https://docs.mollie.com/docs/authentication) (`access_...`):

-   `balances`
-   `balance_transactions`
-   `settlements`
-   `profiles`

To sync these tables, connect an access token that is scoped to your payment profile and has read permissions for those resources. Regular API keys cannot access these endpoints.

## Configuration

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

## Supported tables

| Table | Description | Sync method | Incremental field | Primary key |
| --- | --- | --- | --- | --- |
| `payments` | A single attempt to collect money from a customer through Mollie. | Full refresh | — | — |
| `refunds` | A refund of all or part of a Mollie payment back to the customer. | Full refresh | — | — |
| `chargebacks` | A reversed payment initiated by the customer's bank or card issuer. | Full refresh | — | — |
| `customers` | A customer stored in Mollie, used to link payments, mandates, and subscriptions. | Full refresh | — | — |
| `subscriptions` | A recurring payment arrangement that charges a customer on a fixed interval. | Full refresh | — | — |
| `settlements` | A payout of collected funds from Mollie to your bank account. | Full refresh | — | — |
| `payment_links` | A shareable URL that lets a customer pay a set amount through Mollie. | Full refresh | — | — |
| `payouts` | A transfer of funds from a Mollie balance to the bank account configured for that balance. | Full refresh | — | — |
| `invoices` | An invoice that Mollie issued to your organization for the fees it charged. | Full refresh | — | — |
| `balances` | A Mollie balance account. Payments, refunds, fees and payouts are booked to a balance. | Full refresh | — | — |
| `balance_transactions` | A single movement of funds on a Mollie balance, such as a payment, refund, chargeback, fee or settlement. | Full refresh | — | — |
| `settlement_payments` | A payment included in a Mollie settlement. Maps each settled payment to the settlement that paid it out. | Full refresh | — | — |
| `profiles` | A Mollie payment profile (website or app) that payments, payment links and payment methods belong to. | Full refresh | — | — |
| `mandates` | A customer's authorization (mandate) that lets you charge their account or card for recurring payments. | Full refresh | — | — |
| `captures` | A capture of funds on an authorized payment, for payment methods that separate authorization and capture. | Full refresh | — | — |