Skip to content
ActionGitHubUpdated May 2026

How do I commit a file change to GitHub via API?

Short answer: Drop the "GitHubCreate or Update File" 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
Owner
owner
stringRequiredGitHub repository owner — the user or organization login (the part before / in owner/repo URLs).
Repository
repo
stringRequiredGitHub repository name — the part after / in owner/repo URLs. Not the full URL.
File Path
path
stringRequiredFile Path. Example: docs/README.md
Commit Message
message
stringRequiredCommit Message. Example: Update README
File Content (base64)
content
stringRequiredBase64-encoded file content
Branch
branch
stringOptionalGit branch name.
File SHA (required for updates)
sha
stringOptionalGit commit SHA (full 40-char hex, or shortened 7+ chars).
Sample request
{
"owner": "e.g. octocat",
"repo": "e.g. hello-world",
"path": "e.g. docs/README.md",
"message": "e.g. Update README",
"content": "{{trigger.content}}"
}
Returns
{
"commit": {
"sha": "def456",
"message": "Update README"
},
"content": {
"sha": "abc123",
"name": "README.md",
"path": "docs/README.md"
}
}

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

Triggered by

Apps that pair well as the trigger for Create or Update File.

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

FAQ

Questions about Create or Update File.

What does the Create or Update File action do in GitHub?
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.
What inputs does Create or Update File require?
Required: Owner, Repository, File Path, Commit Message, File Content (base64). 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 Create or Update File support batch operations?
Yes. Run Create or Update File 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.

Send create or update file from your workflows.

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