> AI agents: this is one page from PostHog's docs. Full index of Markdown docs for LLMs: https://posthog.com/llms.txt # Set up integrations Canonical URL: https://posthog.com/docs/error-tracking/integrations > **Cloud region:** This page uses US Cloud hosts. For an EU Cloud project, use `https://eu.posthog.com` instead of `https://app.posthog.com` (app host for links). ## On this page - [GitHub integration](#github-integration) - [GitLab integration](#gitlab-integration) - [Linear integration](#linear-integration) - [Jira integration](#jira-integration) - [What's next?](#whats-next) PostHog integrates with GitHub, GitLab, Linear, and Jira to enhance error tracking with source code context, commit information, and external issue tracking. | Integration | Capabilities | | --- | --- | | [GitHub](#github-integration) | Pinpoint Git commits that cause issues, open files in GitHub directly from stack traces, and create GitHub issues from errors | | [GitLab](#gitlab-integration) | Pinpoint Git commits that cause issues, open files in GitLab directly from stack traces, and create GitLab issues from errors | | [Linear](#linear-integration) | Create Linear issues directly from errors and track fixes in your existing Linear workflows | | [Jira](#jira-integration) | Create Jira issues directly from errors and track fixes in your existing Jira workflows | ## GitHub integration To set up the GitHub integration: 1. Go to the [GitHub integration page](https://app.posthog.com/integrations/github) in the PostHog app 2. Click **Connect organization** 3. Authorize PostHog to access your repositories 4. Select the repositories you want to link PostHog connects to GitHub by installing a GitHub application. PostHog needs the following permissions: - Read access to metadata - Read and write access to code, issues, and pull requests The same GitHub App powers Self-driving, PostHog Desktop, and the data warehouse GitHub source. See the [GitHub integration](https://posthog.com/docs/libraries/github.md) page for how installations, repository access, and disconnecting work. Once connected, create a [release](https://posthog.com/docs/error-tracking/releases.md) to start using source linking. ## GitLab integration To set up the GitLab integration: 1. Go to [Error tracking settings](https://app.posthog.com/settings/project-error-tracking) in the PostHog app and find **Integrations** 2. Under **GitLab**, click **Connect project** 3. Provide the following information: - Hostname - Project ID - A project access token with the `api` scope PostHog connects to GitLab using a [project access token](https://docs.gitlab.com/user/project/settings/project_access_tokens). Once connected, create a [release](https://posthog.com/docs/error-tracking/releases.md) to start using source linking. ## Linear integration Connect your Linear workspace to create and track Linear issues directly from error tracking. To set up the Linear integration: 1. Go to the [Linear integration page](https://app.posthog.com/integrations/linear) in the PostHog app 2. Click **Connect workspace** 3. Authorize PostHog to access your Linear workspace PostHog connects to Linear using a [third-party app](https://linear.app/docs/third-party-application-approvals). PostHog needs the following permissions: - Create issues for your workspace - Read access to your workspace ## Jira integration Connect your Jira workspace to create and track Jira issues directly from error tracking. To set up the Jira integration: 1. Go to the [Jira integration page](https://app.posthog.com/integrations/jira) in the PostHog app 2. Click **Connect workspace** 3. Authorize PostHog to access your Jira site PostHog connects to Jira using OAuth 2.0. PostHog needs the following permissions: - Create issues in your Jira projects - Read access to your Jira projects ## What's next? After setting up an integration: 1. [Upload source maps](https://posthog.com/docs/error-tracking/upload-source-maps.md) for better stack traces 2. [Create releases](https://posthog.com/docs/error-tracking/releases.md) to link errors to specific deployments 3. [Create external issues](https://posthog.com/docs/error-tracking/assigning-issues.md#create-external-issues) from the UI, API, or [MCP](https://posthog.com/docs/error-tracking/surfaces/mcp.md)