How it works
GitHub stores software projects and tracks work on them. Connect GitHub to build issue intake tools and project dashboards. Your app acts through the connected GitHub account; this connection does not synchronize the Zite app itself to a GitHub repository. With this integration, you can:- List accessible repositories and read their files
- Create and manage issues
- Open and track pull requests
- Show recent repository changes
- Monitor GitHub Actions run status
How to integrate GitHub into your app
1
Connect to GitHub
Ask Zite to connect GitHub, or click + in the chat box, select Integrations, then choose GitHub. Sign in and approve access, or select Use a personal access token to provide a private access key from GitHub. A fine-grained token lets you choose repositories and permitted actions. Your organization may need to approve access.
2
Describe your use case
Tell Zite which repository and actions your team needs. For example, “Let customers submit bug reports as issues in our Support repository and show staff which reports are still open.”
3
Test and publish
Create a sample issue and confirm its repository, author, and details in GitHub. Test with an app user who should have limited access.Click Publish in the upper right corner when the workflow works as expected.
Common use cases
With GitHub, you can create apps like:- Bug Report Portals: Turn customer reports into issues.
- Project Dashboards: Show issue progress across repositories.
- Review Trackers: Display open pull requests and their status.
- Release Dashboards: Show recent changes and automated check results.
Important notes
- App versioning: This integration lets your app work with GitHub. It does not connect the app’s own project history to your repository.
- Connected identity: All actions use the account you connect. Choose the app’s audience and available actions with that access in mind.
- Missing repositories: Check that both the account and its connection can access the repository, including any organization approval requirements.
- Access keys: Replace a token if it expires or is revoked. Choose only the repositories and actions your app needs.
- Automated checks: Reading GitHub Actions results and changing their setup require different permissions. Standard sign-in does not include permission to change that setup.
- Usage limits: Busy apps share the connected account’s allowance. If requests are temporarily blocked, wait and ask Zite to check GitHub less often.
Need help with this integration? Contact support@zite.com.