Simple Hellodocs
Open app

Jira integration

The Jira integration lets you:

  • Browse a Jira project's issues from a project page.
  • Link a flow node to a specific Jira issue so the diagram references real tracker tickets.

Phase 1 is read-only — no writes back to Jira from Simple Hello.

What you need

  • A Jira Cloud site (the *.atlassian.net flavour).
  • The email of the Atlassian account you want to authenticate as.
  • An Atlassian API token for that account.

Create the API token at id.atlassian.com — Create API token, give it a label, copy it. You only see the token once.

Step 1 — Connect the team

Like GitHub, the Jira credentials live on the team.

  1. Open the team page (Teams → [your team]) → Integrations tab.
  2. On the Jira card, click Connect.
  3. Fill in:
    • Jira site URL — e.g. your-company.atlassian.net (no scheme, no trailing slash).
    • Account email — the email of the user the API token belongs to.
    • API token — paste it in.
  4. Hit Continue (or Save connection if you don't yet have a project open).
Screenshot pending
Connect Jira dialog — three inputs (site URL, email, token) + helper link to id.atlassian.com.

The dialog verifies the credentials by listing your Jira projects.

Step 2 — Link a Jira project

Unlike GitHub (which supports multiple repos), each Simple Hello project links to exactly one Jira project.

  1. Open the project and switch to the Jira tab.
  2. Click Link project.
  3. Pick the Jira project from the dropdown and hit Link project.
Screenshot pending
Link Jira project dialog — single dropdown listing Jira projects as 'Name (KEY)'.

If you don't see the project you expect, the connected account probably doesn't have access — try a different Atlassian account when you connect the team.

What you'll see

On the project page

The Jira tab shows an issue board for the linked Jira project, with status and assignee.

Screenshot pending
Project → Jira tab. List of issues from the linked Jira project, each row showing key, summary, status, assignee.

Inside a flow node

Once a Jira project is linked, the node inspector gains an Issue picker that lists issues from the linked Jira project. Picking one attaches the issue to the node and renders a small status-coloured badge with the issue key on the canvas.

Screenshot pending
Flow editor with one node selected. Inspector shows Jira issue dropdown. Node shows badge like 'PROJ-123' in the canvas.

Click the badge to open the issue in Jira in a new tab.

Managing the connection

  • Reconnect — rotate the API token via the team's Jira card. Project links stay in place.
  • Unlink the project — change which Jira project a Simple Hello project points to (or remove the link entirely) from the project's Jira tab.
  • Disconnect the team — removes the credentials and unlinks the Jira project from every project on the team.

A note on rate limits

Jira Cloud's per-user API rate limits apply to whoever's token you connected. If a single team has many projects all polling the Jira API, expect occasional throttling — the UI surfaces this as a load error you can retry.