What you’ll need
- GitHub Organization Owner role on the org you want to connect.
- Two minutes.
Set it up
Install the Axiom GitHub App
You’ll be redirected to GitHub. Choose the organization to install on, then pick All repositories (recommended for full inventory) or specific repos.
Approve the requested permissions
The Axiom GitHub App requests read-only access to:
- Repository: Metadata, Contents, Issues, Pull requests
- Organization: Members, Administration
What gets synced
| Object | Fields | Refresh cadence |
|---|---|---|
| Members | login, name, email, role (member/admin), 2FA enabled | Every 6 hours |
| Teams | name, description, members, parent team | Every 6 hours |
| Outside collaborators | login, repos accessed | Daily |
| Repository access | repo, who has read/write/admin access | Daily |
Why GitHub App, not OAuth or PAT
GitHub Apps issue fine-grained, expiring tokens scoped to the specific resources you authorized. Personal Access Tokens (the old way) grant a single user’s full account access until manually revoked — much worse for least-privilege.Troubleshooting
Members show but teams don't
Members show but teams don't
Re-check that you installed on the organization, not your personal account. Reinstall via github.com/settings/installations and pick the org.
I want to disconnect
I want to disconnect
Go to Integrations → GitHub → Disconnect in Layer, then uninstall the Axiom app from github.com/organizations/YOUR_ORG/settings/installations.