Connecting Jira with User Name & Token

This page describes how to connect OX to Jira Cloud using a personal Atlassian account's email address and API token.

The recommended path for new Jira Cloud integrations is Connecting Jira with a Service Account. This page is preserved for existing deployments that already use the personal-token method.

Prerequisites

A Jira account.

Step 1: Getting Jira token [Jira]

1. Log in to your Atlassian account.

2. From your profile picture in the top-right corner, select Profile.

1. In your profile settings page, select Manage your account and then select Security.

1. Scroll down to the API Tokens section, select Create and manage API tokens, and then select Create API token.

2. In the Create API token dialog, define the following.

Parameter	Description
Name	A significant name that makes it easy to identify the purpose of the token.
Expires on	Set the expiration date as far as possible.

1. Select Create. The dialog with the token appears.

1. Copy the token and store it in a safe location. After closing this dialog you cannot see it again.

Step 2: Connecting to Jira [OX]

1. In the OX app, go to Connectors and search for Jira.

1. Select Jira and set the following parameters in the Configure your Jira credentials dialog.

Parameter	Description
Jira Host URL	Add your organization account URL.
User Name	Type the email address used as your Jira user name.
Token Name	Paste the Jira token you have created.

1. Leave OX Broker off and Bypass SSL Verification not selected unless your environment specifically requires them.

2. Select CONNECT. The success message appears.

Step 3: Adding Jira Tickets