Github integration
Momentic provides GitHub integration through a GitHub App installation, enabling seamless connection between your Momentic workspace and GitHub repositories.
Installation
To set up GitHub integration for your organization:
- Navigate to Settings > Integrations in your Momentic workspace
- Click on the GitHub integration card
- Follow the GitHub app installation flow
Common Installation Errors
During the GitHub app installation process, you might encounter the following errors:
Existing Installation
If you see the message “A GitHub app installation already exists for your organization”, it means your organization already has an active GitHub app installation. You can:
- Use the existing installation
- Remove the existing installation before creating a new one
Missing Parameters
If you receive a message about missing required parameters, ensure you’re initiating the installation through Momentic’s interface rather than trying to set it up manually.
Invalid Setup Action
The setup process requires specific actions to be performed in sequence. If you see an error about an invalid setup action, start the installation process from the beginning through Momentic’s interface.
API Validation Failure
If you encounter a “Failed to validate access to the GitHub API” error, this could be due to:
- Insufficient permissions granted during installation
- Network connectivity issues
- GitHub API availability problems
Troubleshooting
If you encounter installation issues:
- Ensure you have admin permissions in both your GitHub organization and Momentic workspace
- Check that you’ve granted all requested permissions during the installation
- Try removing any existing installations and starting fresh
- Contact Momentic support if issues persist
Security Considerations
The GitHub integration:
- Requires minimal repository permissions
- Uses GitHub’s official OAuth flow
- Follows security best practices for API access
- Can be audited through GitHub’s security logs
Was this page helpful?