GitHub

Overview

Connect GitHub with Flows360

Synchronize issues, files and pull requests with operational workflows.

Use the GitHub connector to include its declared actions and events in Flows360 workflows without duplicating the integration logic inside each consuming system. This pinned connector version currently exposes 93 actions and 14 triggers.

Available actions

• Create Issue
• Get issue information
• Create comment on a issue
• Lock issue
• Unlock issue
• Raw GraphQL query
• Create Pull Request Review Comment
• Create Commit Comment
• Plus 85 additional declared actions.

Available triggers

• New Pull Request
• New Star
• New Issue
• Push
• New Discussion
• New Comment Posted
• Plus 8 additional declared triggers.

The capability list above is generated from the exact reviewed connector package so the public description stays aligned with the version Flows360 operates.

Technical guide

Technical reference

Package identity

• Connector: GitHub
• Package: @activepieces/piece-github@0.9.0
• Exact artifact digest: sha256:6e33b391022a4547a1c4b6d27c96ab516544cd8556ad87bdbf87a63ad8ae0b6e
• Runtime: Activepieces-compatible deterministic worker
• Source: the exact reviewed Activepieces source

Authentication

OAUTH2, CUSTOM AUTH, SECRET TEXT. Connection values are tenant-specific and remain in the consuming Studio instance; CDK stores definitions and field metadata, not customer credential values.

Action contracts

• Create Issue (github_create_issue), Create Issue in GitHub Repository Classification: read.
• Get issue information (getIssueInformation), Grabs information from a specific issue Classification: read.
• Create comment on a issue (createCommentOnAIssue), Adds a comment to the specified issue (also works with pull requests) Classification: read.
• Lock issue (lockIssue), Locks the specified issue Classification: read.
• Unlock issue (unlockIssue), Unlocks the specified issue Classification: read.
• Raw GraphQL query (rawGraphqlQuery), Perform a raw GraphQL query Classification: read.
• Create Pull Request Review Comment (github_create_pull_request_review_comment), Creates a review comment on a pull request in a GitHub repository Classification: read.
• Create Commit Comment (github_create_commit_comment), Creates a comment on a commit in a GitHub repository Classification: read.
• Create Discussion Comment (github_create_discussion_comment), Creates a comment on a discussion in a GitHub repository Classification: read.
• Add Labels to Issue (add_labels_to_issue), Adds labels to an existing issue. Classification: read.
• Create Branch (create_branch), Creates a new branch on a repository. Classification: read.
• Delete Branch (delete_branch), Deletes a branch from a repository. Classification: read.
• Update Issue (update_issue), Updates an existing issue. Classification: read.
• Find Branch (find_branch), Finds a branch by name and returns its details. Classification: read.
• Find Issue (find_issue), Finds an issue based title. Classification: read.
• Find User (find_user), Finds a user by their login name. Classification: read.
• Create Gist (github_create_gist), Create a GitHub Gist. Requires an OAuth or personal access token connection, Gists cannot be created with GitHub App authentication. Classification: read.
• Trigger Workflow Dispatch (trigger_workflow_dispatch), Manually triggers a GitHub Actions workflow run via the workflow_dispatch event. Classification: read.
• Create Issue (Agent) (create_issue_ai), Opens a new issue in a GitHub repository. Classification: read.
• Get Issue (Agent) (get_issue_ai), Fetches the full details of a single issue by number. Classification: read.
• List Repository Issues (Agent) (list_repository_issues), Lists issues in a repository with optional filters. Classification: read.
• Update Issue (Agent) (update_issue_ai), Edits an existing issue, including closing or reopening it. Classification: read.
• Create Issue Comment (Agent) (create_issue_comment_ai), Posts a comment on an issue or pull request. Classification: read.
• List Issue Comments (Agent) (list_issue_comments), Lists the comments on an issue or pull request. Classification: read.
• Lock Issue (Agent) (lock_issue_ai), Locks an issue or pull request conversation. Classification: read.
• Unlock Issue (Agent) (unlock_issue_ai), Removes the conversation lock from an issue or pull request. Classification: read.
• Add Labels to Issue (Agent) (add_labels_to_issue_ai), Adds labels to an issue without removing existing ones. Classification: read.
• Remove Label from Issue (Agent) (remove_label_from_issue), Detaches a single label from an issue or pull request. Classification: read.
• Set Issue Labels (Agent) (set_issue_labels), Replaces the entire label set on an issue or pull request. Classification: read.
• List Issue Labels (Agent) (list_issue_labels), Lists the labels currently on an issue or pull request. Classification: read.
• Add Assignees to Issue (Agent) (add_assignees_to_issue), Assigns users to an issue or pull request. Classification: read.
• Remove Assignees from Issue (Agent) (remove_assignees_from_issue), Unassigns users from an issue or pull request. Classification: read.
• List Assignees (Agent) (list_assignees), Lists users who can be assigned to issues in a repository. Classification: read.
• List Repository Labels (Agent) (list_repository_labels), Lists a repository's label vocabulary. Classification: read.
• Create Label (Agent) (create_label), Defines a new label in a repository. Classification: read.
• Update Label (Agent) (update_label), Renames or recolors an existing repository label. Classification: read.
• Create Pull Request (Agent) (create_pull_request), Opens a pull request between two branches. Classification: read.
• Get Pull Request (Agent) (get_pull_request), Fetches a single pull request by number. Classification: read.
• List Pull Requests (Agent) (list_pull_requests), Lists pull requests in a repository with optional filters. Classification: read.
• Update Pull Request (Agent) (update_pull_request), Edits a pull request, including closing or reopening it. Classification: read.
• Merge Pull Request (Agent) (merge_pull_request), Merges an open pull request into its base branch. Classification: read.
• List Pull Request Files (Agent) (list_pull_request_files), Lists the files changed in a pull request. Classification: read.
• List Pull Request Commits (Agent) (list_pull_request_commits), Lists the commits in a pull request. Classification: read.
• Create Pull Request Review (Agent) (create_pull_request_review), Submits a review on a pull request. Classification: read.
• Request Pull Request Reviewers (Agent) (request_pull_request_reviewers), Requests reviews from users or teams on a pull request. Classification: read.
• Create Pull Request Review Comment (Agent) (create_pull_request_review_comment_ai), Posts an inline review comment on a pull request. Classification: read.
• List Pull Request Review Comments (Agent) (list_pull_request_review_comments), Lists inline review comments on a pull request. Classification: read.
• List Pull Request Reviews (Agent) (list_pull_request_reviews), Lists the reviews submitted on a pull request. Classification: read.
• Get Repository (Agent) (get_repository), Fetches metadata for a single repository. Classification: read.
• List My Repositories (Agent) (list_my_repositories), Lists repositories the connected account can access. Classification: read.
• List User Repositories (Agent) (list_user_repositories), Lists a specific user's public repositories. Classification: read.
• List Organization Repositories (Agent) (list_organization_repositories), Lists the repositories in an organization. Classification: read.
• Create Repository (Agent) (create_repository), Creates a new repository for the authenticated user. Classification: read.
• Create Organization Repository (Agent) (create_organization_repository), Creates a new repository inside an organization. Classification: read.
• Update Repository (Agent) (update_repository), Updates settings on a repository. Classification: read.
• List Branches (Agent) (list_branches), Lists the branches in a repository. Classification: read.
• Get Branch (Agent) (get_branch), Fetches a single branch including its tip commit. Classification: read.
• List Commits (Agent) (list_commits), Lists commits in a repository with optional filters. Classification: read.
• Get Commit (Agent) (get_commit), Fetches a single commit including its file changes. Classification: read.
• Compare Commits (Agent) (compare_commits), Compares two commits, branches, or tags. Classification: read.
• List Contributors (Agent) (list_contributors), Lists the contributors to a repository. Classification: read.
• List Languages (Agent) (list_languages), Returns the language byte-count map for a repository. Classification: read.
• List Tags (Agent) (list_tags), Lists the git tags in a repository. Classification: read.
• Get File Content (Agent) (get_file_content), Reads a file (or directory listing) from a repository. Classification: read.
• Create or Update File (Agent) (create_or_update_file), Creates or updates a single file via a commit. Classification: read.
• Delete File (Agent) (delete_file), Deletes a file from a repository via a commit. Classification: read.
• Get Repository Tree (Agent) (get_repository_tree), Lists the full file tree at a given ref. Classification: read.
• Create Branch (Agent) (create_branch_ai), Creates a new branch from the tip of a source branch. Classification: read.
• Get Reference (Agent) (get_reference), Resolves a git ref to its commit SHA. Classification: read.
• Delete Branch (Agent) (delete_branch_ai), Deletes a branch from a repository. Classification: read.
• Search Repositories (Agent) (search_repositories), Searches public/accessible repositories with a query. Classification: read.
• Search Issues and Pull Requests (Agent) (search_issues_and_pull_requests), Searches issues and PRs across repositories with a query. Classification: read.
• Search Code (Agent) (search_code), Searches file contents across repositories. Classification: read.
• Search Users (Agent) (search_users), Searches GitHub users and organizations. Classification: read.
• Get Authenticated User (Agent) (get_authenticated_user), Returns the profile of the connected account. Classification: read.
• Get User (Agent) (get_user), Fetches a user's public profile by login. Classification: read.
• List Organization Members (Agent) (list_organization_members), Lists the members of an organization. Classification: read.
• Create Release (Agent) (create_release), Creates a release for a tag. Classification: read.
• List Releases (Agent) (list_releases), Lists the releases in a repository. Classification: read.
• Get Release (Agent) (get_release), Fetches a single release by its id. Classification: read.
• Get Latest Release (Agent) (get_latest_release), Fetches the latest published release. Classification: read.
• List Collaborators (Agent) (list_collaborators), Lists the collaborators on a repository. Classification: read.
• Add Collaborator (Agent) (add_collaborator), Invites a user as a repository collaborator. Classification: read.
• Remove Collaborator (Agent) (remove_collaborator), Revokes a user's collaborator access to a repository. Classification: read.
• Create Milestone (Agent) (create_milestone), Creates a milestone in a repository. Classification: read.
• List Milestones (Agent) (list_milestones), Lists the milestones in a repository. Classification: read.
• Get Milestone (Agent) (get_milestone), Fetches a single milestone by number. Classification: read.
• Update Milestone (Agent) (update_milestone), Updates a milestone, including closing or reopening it. Classification: read.
• Star Repository (Agent) (star_repository), Stars a repository for the connected user. Classification: read.
• Unstar Repository (Agent) (unstar_repository), Removes a star from a repository for the connected user. Classification: read.
• List Starred Repositories (Agent) (list_starred_repositories), Lists the repositories the connected user has starred. Classification: read.
• Check Repository Starred (Agent) (check_repository_starred), Checks whether the connected user has starred a repository. Classification: read.
• Custom API Call (custom_api_call), Make a custom API call to a specific endpoint Classification: read.

Trigger contracts

• New Pull Request, webhook.
• New Star, webhook.
• New Issue, webhook.
• Push, webhook.
• New Discussion, webhook.
• New Comment Posted, webhook.
• New Branch, webhook.
• New Collaborator, webhook.
• New Label, webhook.
• New Milestone, webhook.
• New Release, webhook.
• New Commit, webhook.
• New Review Request, webhook.
• New Mention, webhook.

Verification

Deterministic execution evidence is recorded for the pinned artifact, including 1 exercised action entrypoint and 0 exercised trigger entrypoints.

Capability summary

Authentication

Authentication method: OAuth 2.0, custom

Required scopes

Authentication profiles

Supported objects

Triggers

Setup

Setup

1. Add the GitHub connector to the workflow in the target Flows360 Studio instance.
2. Create or select the tenant-specific connection required by the connector. Connection secrets remain in the Studio connection boundary and are not copied into CDK documentation.
3. Provide the connection fields declared by the pinned package:

• App ID or Client ID (appId), required.
• Installation ID (installationId), required.
• Private Key (privateKey), required; stored as a sensitive connection value.

OAuth scopes

• admin:repo_hook
• admin:org
• repo
• gist

1. Select the required action or trigger and complete its declared input fields. Required and optional inputs are defined by the exact package schema.
2. Test the workflow in the appropriate environment before enabling production scheduling or event delivery.

Limitations

Limitations and operational notes

• This content describes @activepieces/piece-github@0.9.0; provider behaviour can change independently and should be revalidated when the provider or connector version changes.
• Only the 93 actions and 14 triggers declared by this pinned package are represented here.
• Tenant credentials and connection values are not stored in the public connector record.
• Provider-side permissions, account entitlements, quotas and rate limits remain subject to the connected provider account and are not inferred when the package does not declare them.
• Deterministic execution evidence is recorded for the pinned artifact, including 1 exercised action entrypoint and 0 exercised trigger entrypoints.

Troubleshooting

Related documentation