Skip to main content

Documentation

Jira sync

Connect Jira Cloud so Clarion can link and update issues from your board.

Overview

Jira credentials are stored per organization in Settings → Integrations. Clarion uses them to mirror tasks, push updates after local writes, and optionally auto-create issues for new Clarion tasks.

1. Create an Atlassian API token

  1. Sign in to Atlassian with the account Clarion should act as.
  2. Open https://id.atlassian.com/manage-profile/security/api-tokens and create an API token.
  3. Copy the token immediately — Atlassian only shows it once.

2. Collect site details

  • Site URL — your Jira Cloud host, for example https://yourcompany.atlassian.net
  • Atlassian email — the email of the account that owns the API token
  • Project key — short key on issues, for example ENG
  • Board ID — numeric board id from the board URL (…/boards/42 → 42). Use a Scrum board if you want sprint sync.

3. Paste credentials in Clarion

  1. Sign in to https://dashboard.tryclarion.ai as an org admin.
  2. Open Settings → Integrations → Jira.
  3. Fill Site URL, Atlassian email, API token, Project key, and Board ID.
  4. Optionally enable Auto-create Jira issues for new Clarion tasks.
  5. Click Save Jira, then Test.

Note. Clarion writes to Clarion first, then pushes to Jira. A failed push is logged in activity — local work is not rolled back.

Troubleshooting

  • 401 / 403 — wrong email/token, or the account cannot access the project.
  • Board not found — confirm the board id and that the project uses that board.
  • Sprints missing — point Board ID at a Scrum board (Kanban boards have no sprints).