;}%20.st6{fill:url(%23SVGID_00000021089067129159788970000008246765442136188072_);}%20.st7{fill:url(%23SVGID_00000117639240116366130650000015074833605515028638_);}%20.st8{opacity:0.4;fill:url(%23SVGID_00000101781798616409025840000016567063639337360777_);}%20.st9{opacity:0.4;fill:url(%23SVGID_00000052086836598721292040000002033117744178971046_);}%20.st10{opacity:0.4;fill:url(%23SVGID_00000159460939004760751800000002448009281983951536_);}%20.st11{opacity:0.4;fill:url(%23SVGID_00000013177830667419993080000017721442101626521532_);}%20.st12{opacity:0.4;fill:url(%23SVGID_00000152235521444854938490000006526001119318383285_);}%20.st13{opacity:0.4;fill:url(%23SVGID_00000119823135212293698520000012774889010992664993_);}%20%3c/style%3e%3cg%3e%3cpolygon%20class='st2'%20points='134.78,14.22%20114.31,48.21%20101.33,69.75%20158.22,69.75%20177.97,36.95%20191.67,14.22%20'/%3e%3cpolygon%20class='st3'%20points='227.55,69.75%20186.61,69.75%20101.33,69.75%20129.78,119.02%20158.16,119.02%20228.61,119.02%20256,119.02%20'/%3e%3cpolygon%20class='st3'%20points='136.93,132.47%20116.46,167.93%2073.82,241.78%20130.71,241.78%20144.9,217.2%20180.13,156.18%20193.82,132.46%20'/%3e%3cpolygon%20class='st3'%20points='121.7,131.95%20101.23,96.49%2058.59,22.63%2030.15,71.91%2044.34,96.49%2079.57,157.5%2093.26,181.22%20'/%3e%3cpolygon%20class='st2'%20points='64.81,131.95%2025.15,131.21%200,130.74%2028.44,180.01%2066.73,180.72%2093.26,181.21%20'/%3e%3cpolygon%20class='st2'%20points='165.38,181.74%20184.58,216.46%20196.75,238.47%20225.19,189.2%20206.66,155.69%20193.83,132.46%20'/%3e%3c/g%3e%3c/svg%3e)
Windmill HubGitHub
Developer tools OAuth, or a personal access tokenOpen issues, review pull requests and read repository state from any Windmill script, flow or app.
What you can do with GitHub
Complete, deployable projects built around GitHub — the fastest way to get something real running.
Set up in 2 steps
Connect from the Resources page
Open Resources, click Add a resource/API and pick github from the OAuth APIs list. Click Connect, allow access in the window that opens, then name the resource and save it. Windmill asks GitHub for the repo and workflow scopes.
Run your first script
Fork any script below and run it against one of your repositories.
Scripts
Building blocks, if none of the projects above fit. Fork one, run it, or call it as a step inside your own flow.
Notify of new Github repo stars
List newly added issues
Get Repository
Create Issue
Get Repo Star Count
Get Repo Content
Dispatch Workflow Run
Get a user
GitHub native trigger template script
Get repository content
Create Branch
Follow a user
Update a release
Get GitHub Actions permissions for a repository
Get a release by tag name
Create or update a repository secret
Get a public SSH key for the authenticated user
List runner applications for a repository
Unstar a repository for the authenticated user
Unblock a user
Create a team
Set interaction restrictions for a repository
Download an organization migration archive
List gists for the authenticated user
Redeliver a delivery for an app webhook
Merge a pull request
Get a job for a workflow run
Delete access restrictions
Get a webhook configuration for a repository
List public repositories
Flows
Multi-step workflows that already wire GitHub to something else.
Trigger flows from GitHub
GitHub is not only a destination. These inbound paths are supported today.
Repository webhooks
Point a repository webhook at a flow's webhook URL and every push starts a run.
Pull request events
Subscribe to pull_request to run checks or gate a deploy.
Resource type
github — the shape of the credential every script on this page expects.
| Field | Type | Required | What it is |
|---|---|---|---|
| token | string | Yes |
All resource types
Questions
OAuth or a personal access token?
OAuth is one click and the token it stores does not expire. Reach for a personal access token when you script the setup, when you want a token scoped to fewer repositories, or when your instance has no OAuth client configured.
Classic or fine-grained token?
Either works. Fine-grained tokens are scoped per repository and expire.
There is no Connect button on my instance
Self-hosted instances need an OAuth client configured once by an admin before the tile appears. Until then, use the token.