# GitHub + Lutril: setup guide

> GitHub connects through OAuth. You enter the organization Lutril should manage, then authorize the Lutril app, which requests read access to org membership and email so it can sync members.

Source: https://www.lutril.com/integrations/github
Category: Developer tools
Auth: oauth
Last verified: 2026-06-17

---

## Setup

1. In Lutril, open Settings → Integrations and select GitHub.
2. Enter the GitHub organization Lutril should manage, then click Connect.
3. You are redirected to GitHub to authorize the Lutril app for that organization.
4. Review the requested scopes and click Authorize. An organization owner may need to approve org access.
5. GitHub redirects you back to Lutril and the connection is established.

## Access requested

- read:org (read org and team membership)
- admin:org (manage org membership)
- user:email (read email addresses)

## References

- [GitHub documentation](https://docs.github.com/en/apps/oauth-apps/building-oauth-apps/scopes-for-oauth-apps)
- [GitHub console](https://github.com/settings/tokens)
- [Authorizing OAuth apps](https://docs.github.com/en/apps/oauth-apps/using-oauth-apps/authorizing-oauth-apps)
