Use GitHub Apps for organization installs. OAuth can be used for user-scoped access when required.
Steps
- Create a provider instance in the dashboard.
- Enter the GitHub App details (App ID, App slug, and private key).
- Configure the GitHub App URLs:
- Webhook URL:
{{endpoint}}/webhooks/github - Callback URL:
{{endpoint}}/auth/github/callback
- Webhook URL:
- Copy the onboarding URL from the dashboard and install the app on the target org or user account.
After installation, you should see the GitHub installation under your workspace. Githook Cloud registers webhooks automatically during onboarding.
Onboarding URL format
{{endpoint}}/?provider=github&instance={{provider_hash}}&tenant_id={{tenant_id}}&state={{optional_correlation}}
tenant_id is optional for single-tenant usage. state is optional and can be used for correlation.