Select Actions to adjust the guide

Some actions may require additional configuration in the provider to be accessible. Choose the actions you need and the guide will be updated.

Action

Scope(s)

Loading actions...

Dynamic Guide URL

Scopes Selected


          
            Separator

Identify your data region

Your data region determines the base URL for API requests. You can identify your region from your browser's address bar when logged in to PostHog.

US Region: `https://us.posthog.com/...`
EU Region: `https://eu.posthog.com/...`

Generate a personal API key

A personal API key authenticates requests to PostHog.

In PostHog, click Settings at the bottom of the left sidebar. Alternatively, if you are directed to the onboarding page, click the Default project dropdown in the top-right corner, then click the gear icon next to the default project name. On the Settings page, scroll down the left panel and select Personal API keys under the Account section.

On the Personal API keys page, create a new key.

Click Create personal API key.
Enter a descriptive label (e.g., `StackOne Integration`).

Select either All access or Organizations to grant the required access level. Do not select Projects only, as this will cause the connection to fail.

All access (recommended): All organizations and projects your account has access to.
Organizations: Select specific organizations to give access to.
Projects: Not supported — selecting this option alone will result in a connection failure.

Enables actions: Change Organization, Create Actions, Create Dashboards, Create Feature Flags, Create Groups Types Metrics, Create Insights, Create Organizations, Create Projects, Create Role, Create Role Membership, Delete A Session Recording, Delete An Action, Delete An Insight, Delete Groups Types, Delete Groups Types Metrics, Delete Members, Delete Organizations, Delete Projects, Delete Role, Delete Role Membership, Delete Users, List All Actions, List All Activity Log, List All Alerts, List All Dashboards, List All Feature Flags, List All Groups Types, List All Groups Types Metrics, List All Insights, List All Integrations, List All Members, List All Role Memberships, List All Roles, List All Session Recordings, List All Users, Retrieve A Dashboard, Retrieve A Feature Flag, Retrieve An Action, Retrieve An Insight, Retrieve An Organization, Retrieve An Organization Project, Retrieve Groups Types Metrics, Retrieve List, Retrieve Organizations, Retrieve Role, Retrieve Role Membership, Retrieve Users, Update A Dashboard, Update A Feature Flag, Update A Session Recording, Update An Action, Update An Insight, Update Complete Product Onboarding, Update Groups Types Metrics, Update Groups Types Update Metadata, Update Members, Update Partial Organization, Update Partial Organization Project, Update Role, Update Users

Use the Select preset dropdown to choose All access, or configure individual scopes based on your use case:

After creation, copy your new API key and store it securely for use later.

Format: `phx_xxxxxxxxxxxxxxxxxxxxxxxxxxxx`
Note: The key is shown only once; keep it in a secure location.

Find your project token

The project token is required for event capture actions. This field is optional if you do not need capture functionality.

Navigate to Settings > Project > General.

Copy the Project Token value and store it securely for use later.
Format: `phc_xxxxxxxxxxxxxxxxxxxxxxxxxxxx`

Linking the Account from the Hub

Use one of the three Linking Account Methods to access the Hub. Fill out the following fields using details from your provider:

Data Region
Personal API Key
Project Token (Optional)

Click Connect
If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider's authorization flow.
Once authorization is successful, you will see a confirmation popup

If the account linking is successful, you will see the newly linked account in your Accounts page.