JIRA

JIRA is a software development tool for agile teams to plan, track, and release world-class software. Connecting JIRA issues to the rest of your tools helps break down barriers and unleash the potential of your team.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure China regions
Flow Premium All Flow regions
PowerApps Premium All PowerApps regions

To use this integration, you will need a Jira account.

Known Issues and Limitations

  • For authentication, you need to use an API token. To get a token, go to this link.
  • Basic authentication with passwords is deprecated. For more information, see jira API documentation.
  • JIRA Server behind a firewall or with REST API disabled is not supported.

Creating a connection

To connect your account, you will need the following information:

Name Type Description
JIRA instance string

The url where your JIRA instance is hosted (must support https).

Username string

Your JIRA username.

API token securestring

Your API token (https://id.atlassian.com/manage/api-tokens).

Throttling Limits

Name Calls Renewal Period
API calls per connection10060 seconds
Frequency of trigger polls160 seconds

Actions

Add comment

This operation is used to add a comment to an existing JIRA issue.

Create a new issue

This operation is used to create a new issue.

Create a new project

This operation is used to create a new JIRA project.

Get issue by key

This operation is used to retrieve the issue object for a given issue Key.

Get projects

This operation is used to retrieve a list of projects for your JIRA instance.

List users by project

This operation is used to retrieve a list of all users associated with a project.

Add comment

This operation is used to add a comment to an existing JIRA issue.

Parameters

Name Key Required Type Description
Issue Key
issueKey True string

Unique Key of the issue to add a comment to.

Comment
body True string

Body of the comment.

Returns

Create a new issue

This operation is used to create a new issue.

Parameters

Name Key Required Type Description
Project
projectKey True string

Pick a project to create the issue in.

Issue Type Id
id True string

Pick an issue type.

Summary
summary True string

Brief description of the issue.

Reporter Username
name string

Username of the person reporting the issue.

Description
description string

A detailed description of the issue.

Priority Id
id string

Pick a priority for the issue.

Labels
labels string

Enter a comma separated list of labels

Assignee Username
name string

Username of the agent the issue is assigned to.

Parent Issue Id
id string

Set the parent for a sub-task.

Epic Name (epic only)
customfield_10119 string

Required epic name for epic issue type.

Returns

Create a new project

This operation is used to create a new JIRA project.

Parameters

Name Key Required Type Description
Project Key
key True string

The unique key, starts with a capital letter.

Name
name True string

Title of the project.

Type
projectTypeKey True string

Project type key.

Lead
lead True string

Username of the project lead.

Description
description string

Verbose description of the project.

Returns

Get issue by key

This operation is used to retrieve the issue object for a given issue Key.

Parameters

Name Key Required Type Description
Issue Key
issueKey True string

Unique Key of the issue.

Returns

Issue
FullIssue

Get projects

This operation is used to retrieve a list of projects for your JIRA instance.

Returns

Items
ProjectArray

List users by project

This operation is used to retrieve a list of all users associated with a project.

Parameters

Name Key Required Type Description
Project key
projectKey True string

Unique key of the project.

Returns

Items
UserList

Triggers

When a new issue is created

This operation triggers when a new issue is added to the given project.

When a new issue is returned by a JQL query

This operation triggers when a new issue appears in the latest 100 results of a JQL query.

When an issue is closed

This operation triggers when an existing issue is closed in the given project.

When a new issue is created

This operation triggers when a new issue is added to the given project.

Parameters

Name Key Required Type Description
Project
projectKey True string

Unique key of the project to look for new issues.

Returns

Name Path Type Description
Issue Id
id string

The unique id of the Issue.

Issue Key
key string

The unique key of the issue.

Issue URL
self string

Browse to the issue using this URL.

Isue Type Id
fields.issuetype.id string

Unique id of the issue type.

Issue Type Description
fields.issuetype.description string

Uniquw description of the issue type.

Issue Type Icon URL
fields.issuetype.iconUrl string

URL associated with the issue type.

Issue Type Name
fields.issuetype.name string

Title of the issue type.

Time Spent
fields.timespent integer

The time spent on this issue

Project Id
fields.project.id string

The unique Id of the project.

Project Key
fields.project.key string

The unique key of the project.

Project Name
fields.project.name string

Title of the project.

Project Type Key
fields.project.projectTypeKey string

The unique key of the project type.

Aggregate Time Spent
fields.aggregatetimespent integer

The aggregate time spent on sub-tasks.

Resolution Date
fields.resolutiondate date-time

yyyy-MM-ddTHH:mm:ss.fffZ

Work Ratio
fields.workratio integer

The percentage of work logged vs the issue estimate.

Created Date-Time
fields.created date-time

yyyy-MM-ddTHH:mm:ss.fffZ

Priority Icon URL
fields.priority.iconUrl string

Icon associated with the priority type.

Priority Name
fields.priority.name string

Title of the priority type.

Priority Id
fields.priority.id string

Unique id of the priority type.

Time Estimate
fields.timeestimate integer

Time remaining estimated time in seconds.

Original Aggregate Time Estimate
fields.aggregatetimeoriginalestimate integer

The original sum of all sub-task time estimates in seconds.

Assignee Name
fields.assignee.name string

User name of the person issue is assigned to.

Assignee Key
fields.assignee.key string

Unique key of the person issue is assigned to.

Assignee Email
fields.assignee.emailAddress string

Email address of the person issue is assigned to.

Assignee Display Name
fields.assignee.displayName string

Display name of the person issue is assigned to.

Updated Date-Time
fields.updated date-time

yyyy-MM-ddTHH:mm:ss.fffZ

Status Description
fields.status.description string

Verbose description of the status type.

Status Icon URL
fields.status.iconUrl string

Icon associated with the status type.

Status Name
fields.status.name string

Title of the status type.

Status Id
fields.status.id string

Unique id of the status type.

Status Category Id
fields.status.statusCategory.id integer

Unique id of the status category.

Status Category Key
fields.status.statusCategory.key string

Unique key of the status category.

Status Category Color Name
fields.status.statusCategory.colorName string

Color name of the status category.

Status Category Name
fields.status.statusCategory.name string

Name of the status category.

Original Time Estimate
fields.timeoriginalestimate integer

The original time estimate in seconds.

Description
fields.description string

Issue description.

Aggregate Time Estimate
fields.aggregatetimeestimate integer

Time sum of all sub-tasks remaining estimated time in seconds.

Summary
fields.summary string

Brief title of the issue.

Creator Name
fields.creator.name string

Username of the person who created the issue.

Creator Key
fields.creator.key string

Unique key of the person who created the issue.

Creator Email
fields.creator.emailAddress string

Email of the person who created the issue.

Creator Display Name
fields.creator.displayName string

Display name of the person who created the issue.

Reporter Name
fields.reporter.name string

Username of the person who reported the issue.

Reporter Key
fields.reporter.key string

Unique key of the person who reported the issue.

Reporter Email
fields.reporter.emailAddress string

Email of the person who reported the issue.

Reporter Display Name
fields.reporter.displayName string

Display name of the person who reported the issue.

Aggregate Progress Completed
fields.aggregateprogress.progress integer

The total progress completed of all sub-tasks in seconds.

Aggregate Estimated Effort
fields.aggregateprogress.total integer

The total sum of all estimated sub-task effort.

Aggregate Progress Percent
fields.aggregateprogress.percent integer

The percent of aggregate completed progress in relation to estimated effort.

Due Date-Time
fields.duedate date-time

yyyy-MM-ddTHH:mm:ss.fffZ

Progress Completed
fields.progress.progress integer

The progress complete in seconds.

Estimated Effort
fields.progress.total integer

The estimated effort.

Progress Percent
fields.progress.percent integer

The percent of completed progress in relation to estimated effort.

Epic Name (epic only)
fields.customfield_10119 string

Required epic name for epic issue type.

When a new issue is returned by a JQL query

This operation triggers when a new issue appears in the latest 100 results of a JQL query.

Parameters

Name Key Required Type Description
JQL Query
jql True string

Query to use.

Returns

Name Path Type Description
Issue Id
id string

The unique id of the Issue.

Issue Key
key string

The unique key of the issue.

Issue URL
self string

Browse to the issue using this URL.

Isue Type Id
fields.issuetype.id string

Unique id of the issue type.

Issue Type Description
fields.issuetype.description string

Uniquw description of the issue type.

Issue Type Icon URL
fields.issuetype.iconUrl string

URL associated with the issue type.

Issue Type Name
fields.issuetype.name string

Title of the issue type.

Time Spent
fields.timespent integer

The time spent on this issue

Project Id
fields.project.id string

The unique Id of the project.

Project Key
fields.project.key string

The unique key of the project.

Project Name
fields.project.name string

Title of the project.

Project Type Key
fields.project.projectTypeKey string

The unique key of the project type.

Aggregate Time Spent
fields.aggregatetimespent integer

The aggregate time spent on sub-tasks.

Resolution Date
fields.resolutiondate date-time

yyyy-MM-ddTHH:mm:ss.fffZ

Work Ratio
fields.workratio integer

The percentage of work logged vs the issue estimate.

Created Date-Time
fields.created date-time

yyyy-MM-ddTHH:mm:ss.fffZ

Priority Icon URL
fields.priority.iconUrl string

Icon associated with the priority type.

Priority Name
fields.priority.name string

Title of the priority type.

Priority Id
fields.priority.id string

Unique id of the priority type.

Time Estimate
fields.timeestimate integer

Time remaining estimated time in seconds.

Original Aggregate Time Estimate
fields.aggregatetimeoriginalestimate integer

The original sum of all sub-task time estimates in seconds.

Assignee Name
fields.assignee.name string

User name of the person issue is assigned to.

Assignee Key
fields.assignee.key string

Unique key of the person issue is assigned to.

Assignee Email
fields.assignee.emailAddress string

Email address of the person issue is assigned to.

Assignee Display Name
fields.assignee.displayName string

Display name of the person issue is assigned to.

Updated Date-Time
fields.updated date-time

yyyy-MM-ddTHH:mm:ss.fffZ

Status Description
fields.status.description string

Verbose description of the status type.

Status Icon URL
fields.status.iconUrl string

Icon associated with the status type.

Status Name
fields.status.name string

Title of the status type.

Status Id
fields.status.id string

Unique id of the status type.

Status Category Id
fields.status.statusCategory.id integer

Unique id of the status category.

Status Category Key
fields.status.statusCategory.key string

Unique key of the status category.

Status Category Color Name
fields.status.statusCategory.colorName string

Color name of the status category.

Status Category Name
fields.status.statusCategory.name string

Name of the status category.

Original Time Estimate
fields.timeoriginalestimate integer

The original time estimate in seconds.

Description
fields.description string

Issue description.

Aggregate Time Estimate
fields.aggregatetimeestimate integer

Time sum of all sub-tasks remaining estimated time in seconds.

Summary
fields.summary string

Brief title of the issue.

Creator Name
fields.creator.name string

Username of the person who created the issue.

Creator Key
fields.creator.key string

Unique key of the person who created the issue.

Creator Email
fields.creator.emailAddress string

Email of the person who created the issue.

Creator Display Name
fields.creator.displayName string

Display name of the person who created the issue.

Reporter Name
fields.reporter.name string

Username of the person who reported the issue.

Reporter Key
fields.reporter.key string

Unique key of the person who reported the issue.

Reporter Email
fields.reporter.emailAddress string

Email of the person who reported the issue.

Reporter Display Name
fields.reporter.displayName string

Display name of the person who reported the issue.

Aggregate Progress Completed
fields.aggregateprogress.progress integer

The total progress completed of all sub-tasks in seconds.

Aggregate Estimated Effort
fields.aggregateprogress.total integer

The total sum of all estimated sub-task effort.

Aggregate Progress Percent
fields.aggregateprogress.percent integer

The percent of aggregate completed progress in relation to estimated effort.

Due Date-Time
fields.duedate date-time

yyyy-MM-ddTHH:mm:ss.fffZ

Progress Completed
fields.progress.progress integer

The progress complete in seconds.

Estimated Effort
fields.progress.total integer

The estimated effort.

Progress Percent
fields.progress.percent integer

The percent of completed progress in relation to estimated effort.

Epic Name (epic only)
fields.customfield_10119 string

Required epic name for epic issue type.

When an issue is closed

This operation triggers when an existing issue is closed in the given project.

Parameters

Name Key Required Type Description
Project
projectKey True string

Unique key of the project to look for new issues.

Returns

Name Path Type Description
Issue Id
id string

The unique id of the Issue.

Issue Key
key string

The unique key of the issue.

Issue URL
self string

Browse to the issue using this URL.

Isue Type Id
fields.issuetype.id string

Unique id of the issue type.

Issue Type Description
fields.issuetype.description string

Uniquw description of the issue type.

Issue Type Icon URL
fields.issuetype.iconUrl string

URL associated with the issue type.

Issue Type Name
fields.issuetype.name string

Title of the issue type.

Time Spent
fields.timespent integer

The time spent on this issue

Project Id
fields.project.id string

The unique Id of the project.

Project Key
fields.project.key string

The unique key of the project.

Project Name
fields.project.name string

Title of the project.

Project Type Key
fields.project.projectTypeKey string

The unique key of the project type.

Aggregate Time Spent
fields.aggregatetimespent integer

The aggregate time spent on sub-tasks.

Resolution Date
fields.resolutiondate date-time

yyyy-MM-ddTHH:mm:ss.fffZ

Work Ratio
fields.workratio integer

The percentage of work logged vs the issue estimate.

Created Date-Time
fields.created date-time

yyyy-MM-ddTHH:mm:ss.fffZ

Priority Icon URL
fields.priority.iconUrl string

Icon associated with the priority type.

Priority Name
fields.priority.name string

Title of the priority type.

Priority Id
fields.priority.id string

Unique id of the priority type.

Time Estimate
fields.timeestimate integer

Time remaining estimated time in seconds.

Original Aggregate Time Estimate
fields.aggregatetimeoriginalestimate integer

The original sum of all sub-task time estimates in seconds.

Assignee Name
fields.assignee.name string

User name of the person issue is assigned to.

Assignee Key
fields.assignee.key string

Unique key of the person issue is assigned to.

Assignee Email
fields.assignee.emailAddress string

Email address of the person issue is assigned to.

Assignee Display Name
fields.assignee.displayName string

Display name of the person issue is assigned to.

Updated Date-Time
fields.updated date-time

yyyy-MM-ddTHH:mm:ss.fffZ

Status Description
fields.status.description string

Verbose description of the status type.

Status Icon URL
fields.status.iconUrl string

Icon associated with the status type.

Status Name
fields.status.name string

Title of the status type.

Status Id
fields.status.id string

Unique id of the status type.

Status Category Id
fields.status.statusCategory.id integer

Unique id of the status category.

Status Category Key
fields.status.statusCategory.key string

Unique key of the status category.

Status Category Color Name
fields.status.statusCategory.colorName string

Color name of the status category.

Status Category Name
fields.status.statusCategory.name string

Name of the status category.

Original Time Estimate
fields.timeoriginalestimate integer

The original time estimate in seconds.

Description
fields.description string

Issue description.

Aggregate Time Estimate
fields.aggregatetimeestimate integer

Time sum of all sub-tasks remaining estimated time in seconds.

Summary
fields.summary string

Brief title of the issue.

Creator Name
fields.creator.name string

Username of the person who created the issue.

Creator Key
fields.creator.key string

Unique key of the person who created the issue.

Creator Email
fields.creator.emailAddress string

Email of the person who created the issue.

Creator Display Name
fields.creator.displayName string

Display name of the person who created the issue.

Reporter Name
fields.reporter.name string

Username of the person who reported the issue.

Reporter Key
fields.reporter.key string

Unique key of the person who reported the issue.

Reporter Email
fields.reporter.emailAddress string

Email of the person who reported the issue.

Reporter Display Name
fields.reporter.displayName string

Display name of the person who reported the issue.

Aggregate Progress Completed
fields.aggregateprogress.progress integer

The total progress completed of all sub-tasks in seconds.

Aggregate Estimated Effort
fields.aggregateprogress.total integer

The total sum of all estimated sub-task effort.

Aggregate Progress Percent
fields.aggregateprogress.percent integer

The percent of aggregate completed progress in relation to estimated effort.

Due Date-Time
fields.duedate date-time

yyyy-MM-ddTHH:mm:ss.fffZ

Progress Completed
fields.progress.progress integer

The progress complete in seconds.

Estimated Effort
fields.progress.total integer

The estimated effort.

Progress Percent
fields.progress.percent integer

The percent of completed progress in relation to estimated effort.

Epic Name (epic only)
fields.customfield_10119 string

Required epic name for epic issue type.

Definitions

CreateProjectResponse

Name Path Type Description
Project Id
id integer

Unique id of the project.

Project Key
key string

Unique key of the project.

CreateIssueResponse

Name Path Type Description
Issue Id
id string

Unique identifier of the issue.

Issue Key
key string

Unique key of the issue.

ProjectArray

Name Path Type Description
Project Id
id string

The unique Id of the project.

Project Key
key string

The unique key of the project.

Project Name
name string

Name of the project.

Project Type Key
projectTypeKey string

The unique key of the project type.

FullIssue

Name Path Type Description
Issue Id
id string

Unique id of the issue.

Issue Key
key string

Unique key of the issue.

Issue URL
self string

Browse to the issue using this URL.

Issue Type Id
fields.issuetype.id string

Unique id of the issue type.

Issue Type Description
fields.issuetype.description string

Verbose title of the issue type.

Issue Type Icon URL
fields.issuetype.iconUrl string

Icon associated with the issue type.

Issue Type Name
fields.issuetype.name string

Title of the issue type.

Time Spent
fields.timespent string

The time spent on an issue

Project Id
fields.project.id string

The unique id of the project.

Project Key
fields.project.key string

The unique key of the project.

Project Name
fields.project.name string

Title of the project.

Project Type Key
fields.project.projectTypeKey string

Unique key of the project type.

Aggregate Time Spent
fields.aggregatetimespent string

The aggregate time spent on sub-tasks.

Resolution
fields.resolution string

Type of resolution the issue has achieved.

Resolution Date
fields.resolutiondate date-time

yyyy-MM-ddTHH:mm:ss.fffZ

Work Ratio
fields.workratio integer

The percentage of work logged vs the issue estimate.

Created Date
fields.created date-time

yyyy-MM-ddTHH:mm:ss.fffZ

Priority Icon URL
fields.priority.iconUrl string

Icon associated with the issue priority.

Priority Name
fields.priority.name string

Title of the priority.

Priority Id
fields.priority.id string

Id of the issue priority.

Time Estimate
fields.timeestimate integer

Time remaining estimated time in seconds.

Aggregate Time Estimate
fields.aggregatetimeoriginalestimate string

The original sum of all sub-task time estimates in seconds.

Assignee Name
fields.assignee.name string

Username of the person a issue is assigned to.

Assignee Key
fields.assignee.key string

User key of the person issue is assigned to.

Assignee Email
fields.assignee.emailAddress string

Email of the person issue is assigned to.

Assignee Display Name
fields.assignee.displayName string

Display name of the person issue is assigned to.

Updated Date-Time
fields.updated date-time

yyyy-MM-ddTHH:mm:ss.fffZ

Status Description
fields.status.description string

Issue status.

Status Icon URL
fields.status.iconUrl string

Issue status.

Status Name
fields.status.name string

Issue status.

Status Id
fields.status.id string

Issue status.

Status Category Id
fields.status.statusCategory.id integer

Issue status category.

Status Category Key
fields.status.statusCategory.key string

Issue status category.

Status Category Color Name
fields.status.statusCategory.colorName string

Issue status category.

Status Category Name
fields.status.statusCategory.name string

Issue status category.

Original Time Estimate
fields.timeoriginalestimate string

The original time estimate in seconds.

Description
fields.description string

Issue description.

Aggregate Time Estimate
fields.aggregatetimeestimate integer

Time sum of all sub-tasks remaining estimated time in seconds.

Summary
fields.summary string

Title of the issue.

Creator Name
fields.creator.name string

Name of the user who created the issue.

Creator Key
fields.creator.key string

Unique key of the user who created the issue.

Creator Email
fields.creator.emailAddress string

Email of the user who created the issue.

Creator Display Name
fields.creator.displayName string

Name of the user who created the issue.

Reporter Name
fields.reporter.name string

Name of the user who reported the issue.

Reporter Key
fields.reporter.key string

Unique key of the user who reported the issue.

Reporter Email
fields.reporter.emailAddress string

Email of the user who reported the issue.

Reporter Display Name
fields.reporter.displayName string

Display name of the user who reported the issue.

Aggregate Progress Completed
fields.aggregateprogress.progress integer

The total progress completed of all sub-tasks in seconds.

Aggregate Estimated Effort
fields.aggregateprogress.total integer

The total sum of all estimated sub-task effort.

Aggregate Progress Percent
fields.aggregateprogress.percent integer

The percent of aggregate completed progress in relation to estimated effort.

Due Date-Time
fields.duedate date-time

yyyy-MM-ddTHH:mm:ss.fffZ

Progress Completed
fields.progress.progress integer

The progress complete in seconds.

Estimated Effort
fields.progress.total integer

The estimated effort.

Progress Percent
fields.progress.percent integer

The percent of completed progress in relation to estimated effort.

Epic Name (epic only)
fields.customfield_10119 string

Required epic name for epic issue type.

UserList

Name Path Type Description
Name
name string

Username of the project member.

Key
key string

Unique key associated with the user.

Email
emailAddress string

Email address of the user.

displayName
displayName string

Full name of the user.

CommentResponse

Name Path Type Description
Comment Id
id string

Unique id of the comment.

Comment Body
body string

Body of the comment.

Created Date-Time
created date-time

yyyy-MM-ddTHH:mm:ss.fffZ