@devries-cameron20 / composio Mirror · read-only
Fork 0

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

Mirrored from https://github.com/Camo67/composio.git

Synced Nov 21, 04:45 UTC

next
md 46 lines 3.06 KB
Rendered Raw
1 ---
2 type: "reference"
3 title: "GitHub"
4 description: "Public support knowledge for GitHub."
5 category: "auth-config"
6 visibility: "public"
7 timestamp: "2026-06-24T00:00:00Z"
8 tags:
9 - "github"
10 ---
11 # GitHub
12
13
14 ## GitHub V2 triggers do not require creating a webhook endpoint first
15
16 GitHub V2 trigger setup does not require a separate webhook endpoint creation step. The webhook URL is automatically provisioned when the trigger instance is created. Skip the `/webhook_endpoints` call and create or update the trigger directly through `/trigger_instances/{slug}/upsert`.
17
18 ## List GitHub organizations and repositories for the authenticated user
19
20 Use `GITHUB_LIST_ORGANIZATIONS_FOR_THE_AUTHENTICATED_USER` to list organizations available to the authenticated GitHub user. Then use `GITHUB_LIST_ORGANIZATION_REPOSITORIES` to list repositories for a selected organization. During connection, the user should be able to choose the organization they want to grant access to.
21
22 ## GitHub connected-account tokens are redacted from API responses
23
24 Provider tokens are redacted from connected-account API responses for both Composio-managed and customer-owned auth configs. Use Composio tool execution or Proxy Execute when a workflow needs to call GitHub; do not build a flow that reads the OAuth token from connected-account data.
25
26 ## GitHub organization access can require approval from an organization owner
27
28 If a GitHub connection works for personal repositories but cannot access an
29 organization, check whether that organization restricts OAuth app access. The
30 user can open GitHub **Settings → Applications → Authorized OAuth Apps**, select
31 the OAuth app, and request access for the organization. An organization owner
32 must approve the request in GitHub; reconnecting in Composio does not bypass the
33 organization's policy.
34
35 GitHub documents the member request flow at
36 <https://docs.github.com/en/account-and-profile/how-tos/organization-membership/requesting-organization-approval-for-oauth-apps>
37 and the owner approval flow at
38 <https://docs.github.com/en/organizations/managing-oauth-access-to-your-organizations-data/approving-oauth-apps-for-your-organization>.
39
40 ## Session-level tool allowlists are enforced server-side at execution time
41
42 Session-level restrictions are enforced server-side at execution time. When a session is configured with `toolkits`, `tools`, or `tags`, every execution request is validated against the enabled or disabled toolkit list, per-toolkit tool list, and tag filters. Disabled tools are filtered from search results, and execution is blocked before the provider API call if the tool fails validation.
43
44 ## Use custom OAuth credentials for branded GitHub consent and redirect flows
45
46 Composio supports white-labeling the hosted auth page by customizing the logo and app name in Project Settings > Auth Screen. For provider OAuth consent screens such as GitHub, use your own OAuth app credentials so the provider consent screen shows your brand instead of Composio's shared OAuth app. Redirect URLs can also be routed through your own domain so users do not see a Composio domain during the redirect path.