Install and configure the Jira integration

  • Public preview

Install XBOW Integration for Jira from Atlassian Marketplace, then configure it from Jira admin settings.

Jira lists the app in admin settings as “XBOW Jira Integration”.

Install the app

You install XBOW Integration for Jira in the same way as other free Atlassian Marketplace apps. Open the XBOW Integration for Jira listing, then follow the steps in Atlassian’s Install and manage app access.

The XBOW integration app requests the minimal scopes needed to work. Jira scopes are broad, so you grant permission for some actions beyond those the app uses, for example deleting an issue. For details of the permissions actually used by the app, see Jira integration security, permissions, and data handling.

Installation may take a while. Jira notifies you when the app is ready to use.

Open the app settings

  1. In Jira, open Settings, then Marketplace apps.
  2. If Jira shows a redirection page, ignore it and expand the left sidebar.
  3. Under “Apps”, expand XBOW Jira Integration.
  4. Click the view you want to open: Configuration, Mapping, or Events.

Configure the connection

The Configuration view lists five setup steps and tracks each one. A step reads “Missing” or “Needs setup” until you complete it.

Four of the five need action from you. Nothing is needed in “Load webhook signing keys” unless XBOW Support asks you to refresh the keys.

1. Choose integration mode

  1. Select Create Jira work items only for unidirectional mode, or Create Jira work items and keep XBOW updated for bidirectional mode. Bidirectional mode also writes Jira workflow state back to XBOW.
  2. Click Save Mode.

You can change the integration mode later. Switching from bidirectional to unidirectional mode stops further writebacks, but it does not remove the workflow metadata that XBOW has already stored.

2. Connect to XBOW

  1. Select your XBOW region. To identify your region, see Identify your region.
  2. Paste your XBOW organization ID. Copy it from your organization’s URL: https://console.xbow.com/v2/organizations/ORGANIZATION-ID (the base URL varies by region).
  3. Click Save Configuration.

3. Store the XBOW API token

  1. Paste your XBOW API token. To learn how to generate a token, see Generate an API key in the API reference.
  2. Click Save Token.

The integration validates the token by connecting to your XBOW organization. If the connection is successful, the “Current token status” shows “Validated” with the date and time.

The token field is write-only. After you save the token, the app shows only the token status. It does not show the token value again.

4. Connect webhook

  1. Click Connect Webhook.
  2. Confirm that the webhook status shows “Signal received” and a recent signed ping. The step list in the sidebar calls this “Webhook signal”.

If the webhook signal does not update, open Events and click Show Debug Info. Email that information to support@xbow.com.

If Connect Webhook fails and Events shows a webhook signature problem, click Refresh Signing Keys, then click Connect Webhook again.

Replace the XBOW API token

When you need to rotate the token:

  1. Create a new XBOW API token for the same XBOW organization.
  2. Open Configuration.
  3. Paste the new token.
  4. Click Save Token.
  5. Confirm that validation succeeds.
  6. Revoke the old token in XBOW.

The app stores the new token only after validation succeeds. If validation fails, the existing token remains in use.

Next steps

Was this helpful?