provider usersusers POST /api/users/{uuid}/integrations/github/start/
@utdk/posthog /api/users/{uuid}/integrations/github/start/
Start GitHub personal integration linking
Start GitHub linking: either full App install or OAuth-only (user-to-server). ``**_kwargs`` absorbs ``parent_lookup_uuid`` from the nested ``/api/users/{uuid}/integrations/`` router (same pattern as ``local_evaluation`` under projects). Usually returns ``install_url`` pointing at ``/installations/new`` so the user can pick any GitHub org (new or already connected). GitHub's install page handles both cases: orgs where the app is installed show "Configure" (no admin needed), orgs where it isn't show "Install" (needs admin). **OAuth fast path:** when the current project already has a team-level GitHub installation, and the user has no ``UserIntegration`` for that installation yet, we skip the org picker and redirect straight to ``/login/oauth/authorize`` so the user only authorizes themselves. ``connect_from`` is preserved for first-party clients so they return to the originating client immediately. In both cases the response key is ``install_url`` for compatibility with callers.
uuid path required
string

Try it

Authentication
Configure credentials for PostHog API
usersIntegrationsGithubStartCreate
POST/api/users/{uuid}/integrations/github/start/
Start GitHub linking: either full App install or OAuth-only (user-to-server). ``**_kwargs`` absorbs ``parent_lookup_uuid`` from the nested ``/api/users/{uuid}/integrations/`` router (same pattern as ``local_evaluation`` under projects). Usually returns ``install_url`` pointing at ``/installations/new`` so the user can pick any GitHub org (new or already connected). GitHub's install page handles both cases: orgs where the app is installed show "Configure" (no admin needed), orgs where it isn't show "Install" (needs admin). **OAuth fast path:** when the current project already has a team-level GitHub installation, and the user has no ``UserIntegration`` for that installation yet, we skip the org picker and redirect straight to ``/login/oauth/authorize`` so the user only authorizes themselves. ``connect_from`` is preserved for first-party clients so they return to the originating client immediately. In both cases the response key is ``install_url`` for compatibility with callers.

Parameters

required

Input

Optional team/project id (e.g. PostHog Code); web UI uses the session's current team.

Optional client hint (e.g. posthog_code) for return routing after OAuth.

Configure credentials above to enable sending.

Code snippet
Updates live as you fill in the form above.

TypeScript

import posthog from '@utdk/posthog';

await posthog.usersIntegrationsGithubStartCreate()