> ## Documentation Index
> Fetch the complete documentation index at: https://docs.synscribe.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How to connect PostHog or Mixpanel

> Connect your product analytics on the Features tab under Settings, PostHog via OAuth or Mixpanel via credentials.

Connect your product analytics on the Features tab under Settings (`settings/features`).
PostHog is the default and uses OAuth — click Connect PostHog, consent, pick the Project, and Test
connection; use Mixpanel (credential-based: service account or project API secret, with a region and
project id) only if that's what you already run. Connecting the account is this step;
building dashboards and funnels comes later in
[2.6.1 PostHog dashboard setup](/platform/posthog-dashboard-setup). First move after connecting: do
read-only reconnaissance and save to memory what's already set up before changing anything. Analytics
is how you prove content converts and spot AI-answer-engine traffic (see
[Part 1 §1.10 Attribution](/theory/attribution)).

| Tool              | Auth                                                | Reach for it when                          |
| ----------------- | --------------------------------------------------- | ------------------------------------------ |
| PostHog (default) | OAuth (no keys to paste)                            | You have no analytics yet, or are flexible |
| Mixpanel          | Credentials (service account or project API secret) | You already run Mixpanel                   |

## Connect PostHog (default)

PostHog uses OAuth, so there are no API-key fields to paste.

1. Go to the Features tab under Settings (`settings/features`) and open the PostHog card.
2. Click **Connect PostHog** and complete the OAuth consent.
3. Pick your **Project** from the dropdown (shown as `name (id)`). The region comes back from OAuth automatically.
4. Click **Test connection** to confirm.

## Connect Mixpanel (alternative)

Mixpanel is credential-based, with no OAuth.

1. On the Features tab under Settings, open the Mixpanel card.
2. For **Auth method**, choose **Service account (recommended)** or **Project API secret**.
3. Pick a **Region**: US, EU, or India.
4. Enter credentials. For a service account, that's the **Service account username** and **Service account secret**; for API secret, it's the **API secret** (find it in Mixpanel under Project Settings, Access Keys, API Secret).
5. Enter the **Project id** (required for service accounts), then **Test connection** and **Save**.

## First move after connecting: explore, don't touch

When you first connect an analytics account, do read-only reconnaissance before you change anything,
and record what was already there so later sessions don't clobber your existing setup:

```text theme={null}
I just connected [analytics tool]. Help me do an initial exploration of my insights and
dashboards — do NOT add or write anything yet. The goal is to understand what's already set
up and what else I need to do.
```

```text theme={null}
Save to memory what's already set up and what not to touch.
```

> 🎥 **Video:** [Conversion tracking on PostHog](https://www.loom.com/share/2d9bc938ae4641bf9a29f84aaef33606).
> It shows the tracking setup; connecting the account, covered above, is the prerequisite.

**Back to:** [2.1 Account setup](/platform/index#2-1-—-account-setup) · **Next:** [2.1.5 Publishing platform + IndexNow](/platform/publishing-platform-indexnow) · **Then:** [2.6.1 PostHog dashboard setup](/platform/posthog-dashboard-setup)
