Skip to content

PostHog connects with a personal API key. Pick US Cloud, EU Cloud, or enter the URL of your self-hosted instance.

Install the PostHog integration

Install PostHog from Available integrations in each environment you connect accounts from.

Create a personal API key

  1. Sign in to PostHog and open your account settings.
  2. In Personal API Keys, click Create a Personal API Key. Create a personal API key
  3. Enter a label and select only the scopes for the endpoints you need.
  4. Copy the key straight away. PostHog doesn't show it again.

The browser URL shows which cloud your PostHog is on.

PostHog URL

Connect a PostHog account

  1. Click Connect Account. Click Connect Account

  2. Enter a Tenant ID. This can be any ID you choose. Click Get connection link. Get connection link

  3. Open the generated link. You can also share it with your customer so they connect their own PostHog account. Share connection link

  4. Select PostHog.

  5. Fill in the form and click Connect:

    Field Required What to enter
    API Key Yes Your PostHog personal API key.
    Base URL No Where your PostHog runs. Pick one of US Cloud, EU Cloud, Self-Hosted. Defaults to US Cloud.
    Self-Hosted URL No Only when Base URL is Self-Hosted: your instance's URL, for example https://posthog.acme.com.
  6. Close the tab when you see the connection successful message. The new account appears under Integrated Accounts. Click its Account ID to see its details and make API calls.