JIRA (Preview)

JIRA (Preview)

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 Government regions
     -   Azure China regions
Flow Premium All Flow regions
PowerApps Premium All PowerApps regions

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds
Frequency of trigger polls 1 60 seconds

Creating a connection

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

JIRA instance
string
The url where your JIRA instance is hosted (must support https).
Username
string
Your JIRA username.
API token or Password
securestring
Your API token (https://id.atlassian.com/manage/api-tokens) or JIRA password.

Actions

Add comment

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

Required Parameters

Issue Key
string
Unique Key of the issue to add a comment to.
Comment
string
Body of the comment.

Returns

Create a new issue

This operation is used to create a new issue.

Required Parameters

Project
string
Pick a project to create the issue in.
Issue Type Id
string
Pick an issue type.
Summary
string
Brief description of the issue.

Optional Parameters

Reporter Username
string
Username of the person reporting the issue.
Description
string
A detailed description of the issue.
Priority Id
string
Pick a priority for the issue.
Labels
string
Enter a comma separated list of labels
Assignee Username
string
Username of the agent the issue is assigned to.
Parent Issue Id
string
Set the parent for a sub-task.
Epic Name (epic only)
string
Required epic name for epic issue type.

Returns

Create a new project

This operation is used to create a new JIRA project.

Required Parameters

Project Key
string
The unique key, starts with a capital letter.
Name
string
Title of the project.
Type
string
Project type key.
Lead
string
Username of the project lead.

Optional Parameters

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.

Required Parameters

Issue Key
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.

Required Parameters

Issue Key
string
Unique Key of the issue to add a comment to.
Comment
string
Body of the comment.

Returns

Items
ProjectArray

List users by project

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

Required Parameters

Project key
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.

Required Parameters

Project
string
Unique key of the project to look for new issues.

Returns

Issue Id
string
The unique id of the Issue.
Issue Key
string
The unique key of the issue.
Issue URL
string
Browse to the issue using this URL.
Isue Type Id
string
Unique id of the issue type.
Issue Type Description
string
Uniquw description of the issue type.
Issue Type Icon URL
string
URL associated with the issue type.
Issue Type Name
string
Title of the issue type.
Time Spent
integer
The time spent on this issue
Project Id
string
The unique Id of the project.
Project Key
string
The unique key of the project.
Project Name
string
Title of the project.
Project Type Key
string
The unique key of the project type.
Aggregate Time Spent
integer
The aggregate time spent on sub-tasks.
Resolution Date
date-time
yyyy-MM-ddTHH:mm:ss.fffZ
Work Ratio
integer
The percentage of work logged vs the issue estimate.
Created Date-Time
date-time
yyyy-MM-ddTHH:mm:ss.fffZ
Priority Icon URL
string
Icon associated with the priority type.
Priority Name
string
Title of the priority type.
Priority Id
string
Unique id of the priority type.
Time Estimate
integer
Time remaining estimated time in seconds.
Original Aggregate Time Estimate
integer
The original sum of all sub-task time estimates in seconds.
Assignee Name
string
User name of the person issue is assigned to.
Assignee Key
string
Unique key of the person issue is assigned to.
Assignee Email
string
Email address of the person issue is assigned to.
Assignee Display Name
string
Display name of the person issue is assigned to.
Updated Date-Time
date-time
yyyy-MM-ddTHH:mm:ss.fffZ
Status Description
string
Verbose description of the status type.
Status Icon URL
string
Icon associated with the status type.
Status Name
string
Title of the status type.
Status Id
string
Unique id of the status type.
Status Category Id
integer
Unique id of the status category.
Status Category Key
string
Unique key of the status category.
Status Category Color Name
string
Color name of the status category.
Status Category Name
string
Name of the status category.
Original Time Estimate
integer
The original time estimate in seconds.
Description
string
Issue description.
Aggregate Time Estimate
integer
Time sum of all sub-tasks remaining estimated time in seconds.
Summary
string
Brief title of the issue.
Creator Name
string
Username of the person who created the issue.
Creator Key
string
Unique key of the person who created the issue.
Creator Email
string
Email of the person who created the issue.
Creator Display Name
string
Display name of the person who created the issue.
Reporter Name
string
Username of the person who reported the issue.
Reporter Key
string
Unique key of the person who reported the issue.
Reporter Email
string
Email of the person who reported the issue.
Reporter Display Name
string
Display name of the person who reported the issue.
Aggregate Progress Completed
integer
The total progress completed of all sub-tasks in seconds.
Aggregate Estimated Effort
integer
The total sum of all estimated sub-task effort.
Aggregate Progress Percent
integer
The percent of aggregate completed progress in relation to estimated effort.
Due Date-Time
date-time
yyyy-MM-ddTHH:mm:ss.fffZ
Progress Completed
integer
The progress complete in seconds.
Estimated Effort
integer
The estimated effort.
Progress Percent
integer
The percent of completed progress in relation to estimated effort.
Epic Name (epic only)
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.

Required Parameters

JQL Query
string
Query to use.

Returns

Issue Id
string
The unique id of the Issue.
Issue Key
string
The unique key of the issue.
Issue URL
string
Browse to the issue using this URL.
Isue Type Id
string
Unique id of the issue type.
Issue Type Description
string
Uniquw description of the issue type.
Issue Type Icon URL
string
URL associated with the issue type.
Issue Type Name
string
Title of the issue type.
Time Spent
integer
The time spent on this issue
Project Id
string
The unique Id of the project.
Project Key
string
The unique key of the project.
Project Name
string
Title of the project.
Project Type Key
string
The unique key of the project type.
Aggregate Time Spent
integer
The aggregate time spent on sub-tasks.
Resolution Date
date-time
yyyy-MM-ddTHH:mm:ss.fffZ
Work Ratio
integer
The percentage of work logged vs the issue estimate.
Created Date-Time
date-time
yyyy-MM-ddTHH:mm:ss.fffZ
Priority Icon URL
string
Icon associated with the priority type.
Priority Name
string
Title of the priority type.
Priority Id
string
Unique id of the priority type.
Time Estimate
integer
Time remaining estimated time in seconds.
Original Aggregate Time Estimate
integer
The original sum of all sub-task time estimates in seconds.
Assignee Name
string
User name of the person issue is assigned to.
Assignee Key
string
Unique key of the person issue is assigned to.
Assignee Email
string
Email address of the person issue is assigned to.
Assignee Display Name
string
Display name of the person issue is assigned to.
Updated Date-Time
date-time
yyyy-MM-ddTHH:mm:ss.fffZ
Status Description
string
Verbose description of the status type.
Status Icon URL
string
Icon associated with the status type.
Status Name
string
Title of the status type.
Status Id
string
Unique id of the status type.
Status Category Id
integer
Unique id of the status category.
Status Category Key
string
Unique key of the status category.
Status Category Color Name
string
Color name of the status category.
Status Category Name
string
Name of the status category.
Original Time Estimate
integer
The original time estimate in seconds.
Description
string
Issue description.
Aggregate Time Estimate
integer
Time sum of all sub-tasks remaining estimated time in seconds.
Summary
string
Brief title of the issue.
Creator Name
string
Username of the person who created the issue.
Creator Key
string
Unique key of the person who created the issue.
Creator Email
string
Email of the person who created the issue.
Creator Display Name
string
Display name of the person who created the issue.
Reporter Name
string
Username of the person who reported the issue.
Reporter Key
string
Unique key of the person who reported the issue.
Reporter Email
string
Email of the person who reported the issue.
Reporter Display Name
string
Display name of the person who reported the issue.
Aggregate Progress Completed
integer
The total progress completed of all sub-tasks in seconds.
Aggregate Estimated Effort
integer
The total sum of all estimated sub-task effort.
Aggregate Progress Percent
integer
The percent of aggregate completed progress in relation to estimated effort.
Due Date-Time
date-time
yyyy-MM-ddTHH:mm:ss.fffZ
Progress Completed
integer
The progress complete in seconds.
Estimated Effort
integer
The estimated effort.
Progress Percent
integer
The percent of completed progress in relation to estimated effort.
Epic Name (epic only)
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.

Required Parameters

Project
string
Unique key of the project to look for new issues.

Returns

Issue Id
string
The unique id of the Issue.
Issue Key
string
The unique key of the issue.
Issue URL
string
Browse to the issue using this URL.
Isue Type Id
string
Unique id of the issue type.
Issue Type Description
string
Uniquw description of the issue type.
Issue Type Icon URL
string
URL associated with the issue type.
Issue Type Name
string
Title of the issue type.
Time Spent
integer
The time spent on this issue
Project Id
string
The unique Id of the project.
Project Key
string
The unique key of the project.
Project Name
string
Title of the project.
Project Type Key
string
The unique key of the project type.
Aggregate Time Spent
integer
The aggregate time spent on sub-tasks.
Resolution Date
date-time
yyyy-MM-ddTHH:mm:ss.fffZ
Work Ratio
integer
The percentage of work logged vs the issue estimate.
Created Date-Time
date-time
yyyy-MM-ddTHH:mm:ss.fffZ
Priority Icon URL
string
Icon associated with the priority type.
Priority Name
string
Title of the priority type.
Priority Id
string
Unique id of the priority type.
Time Estimate
integer
Time remaining estimated time in seconds.
Original Aggregate Time Estimate
integer
The original sum of all sub-task time estimates in seconds.
Assignee Name
string
User name of the person issue is assigned to.
Assignee Key
string
Unique key of the person issue is assigned to.
Assignee Email
string
Email address of the person issue is assigned to.
Assignee Display Name
string
Display name of the person issue is assigned to.
Updated Date-Time
date-time
yyyy-MM-ddTHH:mm:ss.fffZ
Status Description
string
Verbose description of the status type.
Status Icon URL
string
Icon associated with the status type.
Status Name
string
Title of the status type.
Status Id
string
Unique id of the status type.
Status Category Id
integer
Unique id of the status category.
Status Category Key
string
Unique key of the status category.
Status Category Color Name
string
Color name of the status category.
Status Category Name
string
Name of the status category.
Original Time Estimate
integer
The original time estimate in seconds.
Description
string
Issue description.
Aggregate Time Estimate
integer
Time sum of all sub-tasks remaining estimated time in seconds.
Summary
string
Brief title of the issue.
Creator Name
string
Username of the person who created the issue.
Creator Key
string
Unique key of the person who created the issue.
Creator Email
string
Email of the person who created the issue.
Creator Display Name
string
Display name of the person who created the issue.
Reporter Name
string
Username of the person who reported the issue.
Reporter Key
string
Unique key of the person who reported the issue.
Reporter Email
string
Email of the person who reported the issue.
Reporter Display Name
string
Display name of the person who reported the issue.
Aggregate Progress Completed
integer
The total progress completed of all sub-tasks in seconds.
Aggregate Estimated Effort
integer
The total sum of all estimated sub-task effort.
Aggregate Progress Percent
integer
The percent of aggregate completed progress in relation to estimated effort.
Due Date-Time
date-time
yyyy-MM-ddTHH:mm:ss.fffZ
Progress Completed
integer
The progress complete in seconds.
Estimated Effort
integer
The estimated effort.
Progress Percent
integer
The percent of completed progress in relation to estimated effort.
Epic Name (epic only)
string
Required epic name for epic issue type.

Definitions

CreateProjectResponse

Project Id
integer
Unique id of the project.
Project Key
string
Unique key of the project.

CreateIssueResponse

Issue Id
string
Unique identifier of the issue.
Issue Key
string
Unique key of the issue.

ProjectArray

Project Id
string
The unique Id of the project.
Project Key
string
The unique key of the project.
Project Name
string
Name of the project.
Project Type Key
string
The unique key of the project type.

FullIssue

Aggregate Estimated Effort
integer
The total sum of all estimated sub-task effort.
Aggregate Progress Completed
integer
The total progress completed of all sub-tasks in seconds.
Aggregate Progress Percent
integer
The percent of aggregate completed progress in relation to estimated effort.
Aggregate Time Estimate
string
The original sum of all sub-task time estimates in seconds.
Aggregate Time Estimate
integer
Time sum of all sub-tasks remaining estimated time in seconds.
Aggregate Time Spent
string
The aggregate time spent on sub-tasks.
Assignee Display Name
string
Display name of the person issue is assigned to.
Assignee Email
string
Email of the person issue is assigned to.
Assignee Key
string
User key of the person issue is assigned to.
Assignee Name
string
Username of the person a issue is assigned to.
Created Date
date-time
yyyy-MM-ddTHH:mm:ss.fffZ
Creator Display Name
string
Name of the user who created the issue.
Creator Email
string
Email of the user who created the issue.
Creator Key
string
Unique key of the user who created the issue.
Creator Name
string
Name of the user who created the issue.
Description
string
Issue description.
Due Date-Time
date-time
yyyy-MM-ddTHH:mm:ss.fffZ
Epic Name (epic only)
string
Required epic name for epic issue type.
Estimated Effort
integer
The estimated effort.
Issue Id
string
Unique id of the issue.
Issue Key
string
Unique key of the issue.
Issue Type Description
string
Verbose title of the issue type.
Issue Type Icon URL
string
Icon associated with the issue type.
Issue Type Id
string
Unique id of the issue type.
Issue Type Name
string
Title of the issue type.
Issue URL
string
Browse to the issue using this URL.
Original Time Estimate
string
The original time estimate in seconds.
Priority Icon URL
string
Icon associated with the issue priority.
Priority Id
string
Id of the issue priority.
Priority Name
string
Title of the priority.
Progress Completed
integer
The progress complete in seconds.
Progress Percent
integer
The percent of completed progress in relation to estimated effort.
Project Id
string
The unique id of the project.
Project Key
string
The unique key of the project.
Project Name
string
Title of the project.
Project Type Key
string
Unique key of the project type.
Reporter Display Name
string
Display name of the user who reported the issue.
Reporter Email
string
Email of the user who reported the issue.
Reporter Key
string
Unique key of the user who reported the issue.
Reporter Name
string
Name of the user who reported the issue.
Resolution
string
Type of resolution the issue has achieved.
Resolution Date
date-time
yyyy-MM-ddTHH:mm:ss.fffZ
Status Category Color Name
string
Issue status category.
Status Category Id
integer
Issue status category.
Status Category Key
string
Issue status category.
Status Category Name
string
Issue status category.
Status Description
string
Issue status.
Status Icon URL
string
Issue status.
Status Id
string
Issue status.
Status Name
string
Issue status.
Summary
string
Title of the issue.
Time Estimate
integer
Time remaining estimated time in seconds.
Time Spent
string
The time spent on an issue
Updated Date-Time
date-time
yyyy-MM-ddTHH:mm:ss.fffZ
Work Ratio
integer
The percentage of work logged vs the issue estimate.

UserList

Email
string
Email address of the user.
Key
string
Unique key associated with the user.
Name
string
Username of the project member.
displayName
string
Full name of the user.

CommentResponse

Comment Body
string
Body of the comment.
Comment Id
string
Unique id of the comment.
Created Date-Time
date-time
yyyy-MM-ddTHH:mm:ss.fffZ