---
sourceDocument: Australia Strategic Portfolio Management
sourceDocumentLink: https://www.servicenow.com/docs/r/it-business-management

 Release :

    - australia

ft:locale :

    - en-US

ft:publication_title :

    - Australia Strategic Portfolio Management

ft:clusterId :

    - itbm

bundleId :

    - itbm

workflow :

    - Technology


---

# Connecting Agile Development 2.0 to Jira

# Connecting Agile Development 2.0 to Jira {#ariaid-title1}

* Release version: Australia
* 
* Updated March 12, 2026
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read

Establish a connection between Agile Development 2.0 and Jira using a Jira connection alias and a Jira instance.  
When you connect Agile Development 2.0 to Jira, a webhook is registered in Jira which receives the following event updates between Jira and Agile Development 2.0.

* Creating or updating projects.
* Creating, updating, or deleting information of epic, story, sprint, and any custom table maps and their fields.
{#connect-sn-agile-with-jira__ul_rml_153_hmb}

## Create a Jira connection alias for integration with Agile Development 2.0 {#ariaid-title2}

Create a Basic Auth credential and an HTTP(s) connection with a Jira connection alias
to establish a connection with Jira.

### Before you begin

Roles required:

* admin to create a connection and credential alias
* sn_jira_int.admin or sn_jira_int.user to create basic authorization credentials and HTTP(s) connection
{#create-credential-alias__ul_r5c_s33_hmb}

### Procedure

1. [Create a Connection
   \& Credential alias](https://www.servicenow.com/docs/access?context=connection-alias&version=australia&pubname=australia-platform-security&ft:locale=en-US)  
   * You can use the connection alias (sn_jira_int.Jira) that is available by default.
   * You must create a connection alias for every Jira instance that you use.
   * For Jira server (on-prem) users, ensure that the server_type and server_version connection attributes are present.
   {#create-credential-alias__ul_rwz_hj3_hmb}
2. Create [Basic authorization
   credentials](https://www.servicenow.com/docs/access?context=r_BasicAuthCredentialsForm&version=australia&pubname=australia-platform-security&ft:locale=en-US).  
   Ensure that the user for whom the basic authorization credentials are created has access to all Jira projects.
3. [Create an HTTP(s)
   connection](https://www.servicenow.com/docs/access?context=create-https-connection&version=australia&pubname=australia-platform-security&ft:locale=en-US).

## Create a Jira Instance for integration with Agile Development 2.0 {#ariaid-title3}

Create a Jira instance record using the connection alias that you created to enable the setup of Jira integration with Agile Development 2.0.

### Before you begin

Role required: sn_jira_int.admin or sn_jira_int.user

### Procedure

1. Navigate to AllAgile Jira IntegrationJira Instances.
2. Click New.
3. On the form, fill in the fields.  
   {#create-agile-jira-instance__table_gjy_2tf_sjb__entry__2}

   | Field | Description |
   |-|-|
   | Name | Name of the Jira instance. Enter a name of your choice. |
   | Connection Alias | Jira connection alias that you already created. Use the lookup (![Lookup icon]()) option to select your connection alias. |
   | Version | Jira version. Use the lookup (![Lookup icon]()) option to select your Jira API version. |
   [Table 1. Jira Instance form]

   {#create-agile-jira-instance__table_gjy_2tf_sjb}
4. Click Submit.
{#create-agile-jira-instance__steps_uyl_pqf_sjb}

## Connect Agile Development 2.0 to Jira {#ariaid-title4}

Connect Jira to Agile Development 2.0 to enable the integration.

### Before you begin

Role required: sn_jira_int.user

### Procedure

1. Navigate to AllAgile Jira IntegrationJira Instances.
2. Open your Jira instance record.
3. Click Connect.
{#connect-to-jira__steps_gsp_g5f_sjb}

### Result

* If the connection is successful, the State field on the Jira Instance record shows Connected. A webhook is now registered in Jira to receive update events.
* If the connection could not be established, the State field on the Jira Instance record shows Connection Failed. You can view the reason for the failure in the error message.
{#connect-to-jira__ul_rq5_hwf_sjb}

### What to do next

[Discover and import Jira projects and boards](https://www.servicenow.com/docs/hDka3ur7fkuoHPelJ8UE3w "Discover and import all available Jira projects and boards into Agile Development 2.0 to start using the integration between the two applications.")
.

*[\>]: and then