Jira

Project management Email and API token

Create, update and transition Jira issues, and read projects, boards and sprints, from any Windmill script, flow or app.

Set up in 3 steps

1

Create an API token

At id.atlassian.com, under Security, create an API token. Copy it — it is shown only once.

2

Add the resource in Windmill

Open Resources, add a resource of type jira, and fill domain with your site name (yourteam in yourteam.atlassian.net), username with your Atlassian account email, and password with the API token. Your Atlassian password will not work.

3

Run your first script

Fork Get Current User to check the resource, then Search Issues with JQL to read before writing anything.

Scripts

Building blocks, if none of the projects above fit. Fork one, run it, or call it as a step inside your own flow.

Submit a script →

Trigger flows from Jira

Jira is not only a destination. These inbound paths are supported today.

Jira webhooks on an HTTP route

Create a Windmill HTTP route, then as a Jira admin add a webhook pointing at it under Settings, System, WebHooks, with the events you want and an optional JQL filter. Give the webhook a secret and set the route to Signature authentication with a Custom scheme (header X-Hub-Signature, sha256, hex, prefix sha256=), so only signed deliveries start your flow.

Automation rules

A Jira automation rule's Send web request action can call the same HTTP route on any rule trigger, without admin rights on the whole site.

Resource type

The shape of the credential every script on this page expects.

FieldTypeRequiredWhat it is
domainstringYes
passwordstringYes
usernamestringYes

Questions

What can the token do?

Everything the account behind it can, with every action attributed to that account. Tokens expire within a year; replace the password field before then.

Is my token stored on the hub?

Never. It lives only in your own Windmill workspace, encrypted at rest.