Skip to main content
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
Admin access to your PostHog account is required to generate a personal API key.


​
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.
1
Sign in to PostHog
Sign in to your PostHog account:
2
Navigate to Personal API keys
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.
3
Create a new API key
On the Personal API keys page, create a new key.
  • Click Create personal API key.
  • Enter a descriptive label (e.g., StackOne Integration).
4
Organization & project access
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.
5
Select API scopes
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:
6
Copy the API key
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.
1
Locate Project Token
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
1
Navigate to the Hub
Use one of the three Linking Account Methods to access the Hub.
2
Fill out the fields
Fill out the following fields using details from your provider:
  • Data Region
  • Personal API Key
  • Project Token (Optional)
3
Connect
  • 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.