> ## Documentation Index
> Fetch the complete documentation index at: https://university.triggr-app.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Jira

> Connect Jira Cloud to Triggr with an Atlassian API token, for your own site and for each client that uses Jira.

Triggr works with Jira issues (including JQL search, transitions and comments), projects and statuses.

## Set up Jira

Use an Atlassian account with access to the projects your workflows use. Triggr can only do what that account can.

<Steps>
  <Step title="Create an API token">
    Signed in as that account, go to [id.atlassian.com/manage-profile/security/api-tokens](https://id.atlassian.com/manage-profile/security/api-tokens) and click **Create API token** (not one with scopes). Name it `Triggr`, choose an expiry of up to 365 days and click Create.
  </Step>

  <Step title="Copy the token">
    Click Copy to clipboard. Atlassian shows the token only once.
  </Step>
</Steps>

See Atlassian's [Manage API tokens for your Atlassian account](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/).

## Connect it in Triggr

Jira is configured per client. A workflow that runs for a client never falls back to the Base Configuration, which only workflows that run without a client use.

<Steps>
  <Step title="Open the integration">
    Go to **Integrations > Jira** and click Configure on the Base Configuration card.

    <Frame>
      <img src="https://mintcdn.com/triggr/nyuVXZ1rouDTTEvu/images/integrations-common/base-configuration.png?fit=max&auto=format&n=nyuVXZ1rouDTTEvu&q=85&s=bb81acb082055015f91beda7b4876f35" alt="The Base Configuration card with Status Not Configured, Admin Consent Not Required and a Configure button." width="2272" height="330" data-path="images/integrations-common/base-configuration.png" />
    </Frame>
  </Step>

  <Step title="Enter your site">
    Enter the token's account email as AccountEmail, the ApiToken, and your site address as SiteURL, such as `https://yourcompany.atlassian.net`, then click Save Configuration.

    <Frame>
      <img src="https://mintcdn.com/triggr/nyuVXZ1rouDTTEvu/images/jira/configure.png?fit=max&auto=format&n=nyuVXZ1rouDTTEvu&q=85&s=b508cef41b3a32daf1f7ab766c1c24f0" alt="The Jira configuration window with AccountEmail, ApiToken and SiteURL fields, an Allow insecure TLS switch under Advanced, and a Save Configuration button." width="1344" height="1354" data-path="images/jira/configure.png" />
    </Frame>
  </Step>

  <Step title="Configure each client">
    On the Per-Client Configuration card, click Configure on the client's row and enter the same fields for the Jira site its workflows should use: the client's own, or yours.

    <Frame>
      <img src="https://mintcdn.com/triggr/nyuVXZ1rouDTTEvu/images/integrations-common/per-client-configuration.png?fit=max&auto=format&n=nyuVXZ1rouDTTEvu&q=85&s=11464b4946bea0b580c73330d9114a41" alt="The Per-Client Configuration card listing Acme Corp and Globex, each Not Configured with Admin Consent Not Required and a Configure button." width="2272" height="646" data-path="images/integrations-common/per-client-configuration.png" />
    </Frame>
  </Step>
</Steps>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Authentication errors (401)">
    Check the token hasn't expired, was made with Create API token (not with scopes), and belongs to the AccountEmail account. Check SiteURL is your site address.
  </Accordion>

  <Accordion title="Permission errors or missing issues (403 or 404)">
    The account lacks a project permission such as Browse Projects, Create Issues, Edit Issues, Transition Issues, Delete Issues or Add Comments.
  </Accordion>

  <Accordion title="no Jira integration is configured for this client">
    The workflow ran for a client that shows Not Configured on the Per-Client Configuration card. Configure it, then run the workflow again.
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.