Overview
The Flows360 GitHub connector provides a robust, operator-grade integration for connecting code repositories and project management workflows to any other application in your technology stack.
Core Capabilities:
- Data Synchronization: Automate the flow of data between GitHub and other systems to eliminate manual processes and improve developer productivity.
- Workflow Automation: Sync issues with project management tools (e.g., Jira), create tasks from support tickets (e.g., Zendesk), or archive repository files to cloud storage (e.g., Amazon S3) without writing custom code.
- Cross-Functional Orchestration: Build and orchestrate workflows across different business units. For example, update a Salesforce Opportunity when a feature branch is merged, or notify a Slack channel about a new pull request.
This integration supports creating, updating, and listing records (such as issues), files, and tasks within GitHub repositories.
Capability summary
Authentication
Auth method: OAuth 2.0
Required scopes
repo
Supported objects
| Object | Read | Write | Notes |
|---|---|---|---|
| File | Yes | Yes | Represents a file within a repository. Can be used to read file content or commit new files. |
| Task | Yes | Yes | Represents a GitHub Issue, which can be treated as a task in a project management context. |
| Record | Yes | Yes | Represents a generic GitHub object, such as an Issue or Pull Request. |
Supported actions
| Action | Description |
|---|---|
| create_record | Creates a new record, such as an issue, in a specified repository. |
| update_record | Updates an existing record, such as closing an issue or modifying a pull request. |
| list_records | Lists records, such as issues or pull requests, from a specified repository. |
Setup steps
- Click Connect and provide a name for your connection.
- You will be redirected to GitHub to authenticate. Log in to the GitHub account you wish to connect.
- Review the requested permissions. The connector requires the
reposcope to access repository information, including code, issues, and pull requests, which is necessary for reading from and writing to them. - Click Authorize to grant the requested permissions and finalize the connection.
- You will be redirected back to Flows360. Your GitHub connection is now active and can be used in flows.
Limitations
- This connector is subject to GitHub's API rate limits. For authenticated users, the limit is 5,000 requests per hour. High-volume workflows may require monitoring to avoid exceeding this limit.
- Access to repositories is determined by the permissions of the authenticated user. The connector cannot access repositories that the connected user account does not have permission to view.
- Creating new repositories or modifying repository-level settings is not supported.
Troubleshooting
Why can't I access or find a specific private repository?
The connector can only access repositories that the authenticated GitHub user has been granted permission to view. Ensure the user account you connected to Flows360 has been granted at least read access to the target repository in GitHub's settings. You may need to request access from your organization or repository administrator. If permissions were recently granted, try re-authenticating the connection.