Linking FusionAuth as a source

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.

Learn more
PostHog Wizard hedgehog
Alpha release

This source is currently in alpha. The interface and available tables may change.

Enter your FusionAuth instance's base URL and an API key to pull your FusionAuth authentication and identity data – users, audit logs, event logs, and login records – into the PostHog data warehouse.

Adding a data source

  1. Go to the sources tab of the data pipeline section in PostHog.
  2. Click + New source and then click Link next to FusionAuth.
  3. Next, gather your FusionAuth credentials:
    • Base URL – your FusionAuth instance URL (e.g. https://your-instance.fusionauth.io). Must use HTTPS.
    • API key – create one in the FusionAuth admin UI under Settings > API Keys. The key needs read access to the endpoints you want to sync.
  4. Back in PostHog, enter the credentials and click Next.
  5. 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 FusionAuth data in PostHog.

Required API key permissions

The API key needs read access to the resources you want to sync:

  • /api/user/search
  • /api/system/audit-log/search
  • /api/system/event-log/search
  • /api/system/login-record/search

Available tables

TableDescriptionSync method
UsersUser accounts, including registrations, contact info, and account timestampsFull refresh
AuditLogsAdministrative actions taken in the FusionAuth admin UI or APIIncremental
EventLogsInternal FusionAuth system events such as errors and informational messagesIncremental
LoginRecordsEvery successful and failed login attempt against a FusionAuth applicationIncremental

Incremental tables sync only new or updated records on each run. Full refresh tables reload all data on each sync.

Sync limitations

  • The Users table is full refresh only because the FusionAuth search API has no documented server-side timestamp filter. The search result window is also capped at approximately 10,000 rows.
  • AuditLogs, EventLogs, and LoginRecords require Elasticsearch to be configured on your FusionAuth instance.

Configuration

OptionTypeRequired
FusionAuth base URLtextYes
API keypasswordYes

Supported tables

TableDescriptionSync methodIncremental fieldPrimary key
Users

Full sync only; the search API's result window is capped at ~10,000 rows.

Full refresh
AuditLogs

Administrative actions taken in the FusionAuth admin UI or API, such as user or configuration changes.

Incremental, Full refreshinsertInstant
EventLogs

Internal FusionAuth system events, such as errors and informational/debug messages.

Incremental, Full refreshinsertInstant
LoginRecords

A record of every successful and failed login attempt against a FusionAuth application.

Incremental, Full refreshinstant

Community questions

Was this page useful?