ActionGitHubUpdated June 2026

How do I list branches in a GitHub repository?

Short answer: Drop the "GitHubList Branches" action anywhere in your workflow, map the inputs from upstream nodes, and publish.

Inputs

The fields this action accepts.

Every field can be mapped from an upstream trigger, AI step, table row, or hard-coded literal.

FieldTypeRequiredDescription
Repository Owner
owner
stringRequiredGitHub repository owner — the user or organization login (the part before / in owner/repo URLs).
Repository Name
repo
stringRequiredGitHub repository name — the part after / in owner/repo URLs. Not the full URL.
Protected Only
protected
optionsOptionalProtected Only. Options: All, Protected only, Unprotected only
Per Page
per_page
stringOptionalPer Page. e.g. "30"
Sample request
{
"owner": "e.g. acme-corp",
"repo": "e.g. my-project",
"protected": "{{trigger.protected}}",
"per_page": "30"
}
Returns
[
{
"name": "main",
"commit": {
"sha": "abc123def456"
},
"protected": true
},
{
"name": "feature/login-fix",
"commit": {
"sha": "789def012abc"
},
"protected": false
}
]

Use these fields in downstream nodes for routing, logging, or error handling.

Triggered by

Apps that pair well as the trigger for List Branches.

Any of these apps can fire this action as part of a workflow.

FAQ

Questions about List Branches.

What does the List Branches action do in GitHub?
Lists branches in a GitHub repository with their head SHA and protection status. Used to populate a branch picker before creating a PR.
What inputs does List Branches require?
Required: Repository Owner, Repository Name. Every input accepts a static value or a variable from any upstream node in your workflow.
Can I use dynamic inputs from earlier workflow nodes?
Yes. Any field on this action can pull values from upstream nodes, whether that's a form response, a trigger payload, an AI output, or a lookup result.
What happens if GitHub returns an error?
The workflow pauses on the failed node, the error message is captured in the run log, and you can retry the run with one click. Auto-retry policies are configurable per workflow with exponential backoff up to 5 attempts.
Does List Branches support batch operations?
Yes. Run List Branches inside a Loop node to process arrays. Tiny Command handles GitHub's rate limits automatically so you don't have to throttle manually.
More actions

Other GitHub actions.

Action
Add Labels
Adds labels to a GitHub issue or pull request by name. Used for AI-driven triage or auto-tagging based on file paths touched.
Action
Create Comment
Adds a comment to a GitHub issue or pull request. Used for AI review summaries, build-status pings, or status broadcasts from CI/CD.
Action
Create Issue
Creates a new issue in a GitHub repository with title, body, assignees, labels, milestone, and project. The default write for piping bug reports or alerts into GitHub.
Action
Create or Update File
Creates or updates a file in a GitHub repository in a single commit, with branch, commit message, and content. The SHA is auto-fetched on update; the standard tool for small file commits without a full git client.
Action
Create Pull Request
Creates a new pull request in a GitHub repository from a head branch to a base branch with title, body, and draft flag. Used for auto-PRs from generated code or dependency updates.
Action
Submit PR Review
Submits a review on a GitHub pull request: APPROVE, REQUEST_CHANGES, or COMMENT. Used for AI code review or for cross-system approval gating.

Send list branches from your workflows.

Triggered by anything in the catalog. Free tier available. No credit card.