Connect Jira with CircleCI

Install the CircleCI for Jira app from the Atlassian Marketplace in the appropriate Jira Cloud instance. To do this you must be a Jira Admin

Navigate to the configuration page. To find the configuration page, navigate to admin.atlassian.com, select the appropriate organization, and then on the appropriate Jira instance, click the three-dot menu, and then click Manage Jira apps.

From the Manage apps page, click on the CircleCI for Jira app under User-installed apps to expand the app details and click Configure.

To display the app fully, it is essential that you grant it permission to access Atlassian products on your behalf. Click Allow access to authorize.

For the initial setup you will need to provide your CircleCI Organization ID, which you can find by navigating to Organization Settings  Overview in the CircleCI application.

This integration authenticates via OpenID Connect (OIDC). By default, the organization ID provided is used for audience validation, but this can be modified, or more can be added.

Once you have provided your CircleCI Organization ID and optionally modified the allowed audiences, click Submit to save your changes.

Now copy your Webhook URL for use in the next section.

Begin by saving the Webhook URL from the previous section as an environment variable. This could be added as a Project Environment Variable or within a Context. We recommend naming the variable JIRA_WEBHOOK_URL.

Next, import the Jira orb into your .circleci/config.yml file and implement the jira/notify command at the end of your build and deployment jobs. Detailed and up-to-date configuration examples can be found on the orb page.