> Markdown versions of all pages of this connector library are available by appending `.md` to the page URL. For the full index of connectors, see [llms.txt](https://connectors.appmixer.com/llms.txt).

# Jira connector

- Connector: `appmixer.jira`
- Version: 4.0.5
- Components: 24 (10 triggers, 14 actions)

Jira is a proprietary issue tracking product developed by Atlassian which allows bug tracking and agile project management.

- Connector page: <https://connectors.appmixer.com/connector/appmixer.jira/4.0.5>
- Documentation: <https://docs.appmixer.com/connector-configuration/jira>
- Source code: <https://github.com/clientIO/appmixer-connectors/tree/dev/src/appmixer/jira>
- Download package: <https://connectors.appmixer.com/connector/appmixer.jira/4.0.5/download>

## Authentication

**Type:** OAuth 2

This connector is globally authenticated and verified by Appmixer (Authentication Hub) and is ready to use without registering your own OAuth application with the provider. You can still use your own OAuth credentials (clientId and clientSecret) - see the Connector Configuration section of the documentation. The Authentication Hub is enabled for all hosted Appmixer tenants; on self-managed installations it has to be explicitly set.

**Scopes:**

- `offline_access`
- `read:me`

## Triggers (10)

- [Deleted Issue](https://connectors.appmixer.com/connector/appmixer.jira/4.0.5/component/appmixer.jira.issues.DeletedIssue.md) (`appmixer.jira.issues.DeletedIssue`): Triggers when an issue is deleted (Webhook). Additional scopes: `read:jira-work`.
- [New Issue](https://connectors.appmixer.com/connector/appmixer.jira/4.0.5/component/appmixer.jira.issues.NewIssue.md) (`appmixer.jira.issues.NewIssue`): Triggers when new issue is created. Additional scopes: `read:jira-work`.
- [New Issue Webhook](https://connectors.appmixer.com/connector/appmixer.jira/4.0.5/component/appmixer.jira.issues.NewIssueWebhook.md) (`appmixer.jira.issues.NewIssueWebhook`): Triggers when an issue is created (Webhook). Additional scopes: `read:jira-work`.
- [Updated Issue](https://connectors.appmixer.com/connector/appmixer.jira/4.0.5/component/appmixer.jira.issues.UpdatedIssue.md) (`appmixer.jira.issues.UpdatedIssue`): Triggers when an issue is updated. Issues that are updated after 1 minute of its creation are considered updated. Additional scopes: `read:jira-work`.
- [Updated Issue Webhook](https://connectors.appmixer.com/connector/appmixer.jira/4.0.5/component/appmixer.jira.issues.UpdatedIssueWebhook.md) (`appmixer.jira.issues.UpdatedIssueWebhook`): Triggers when an issue is updated (Webhook). Additional scopes: `read:jira-work`.
- [Deleted Project](https://connectors.appmixer.com/connector/appmixer.jira/4.0.5/component/appmixer.jira.projects.DeletedProject.md) (`appmixer.jira.projects.DeletedProject`): Triggers when a project is deleted. Additional scopes: `read:issue-type:jira`, `read:project:jira`, `read:project.property:jira`, `read:user:jira`, `read:application-role:jira`, `read:avatar:jira`, `read:group:jira`, `read:issue-type-hierarchy:jira`, `read:project-category:jira`, `read:project-version:jira`, `read:project.component:jira`.
- [Deleted Project Webhook](https://connectors.appmixer.com/connector/appmixer.jira/4.0.5/component/appmixer.jira.projects.DeletedProjectWebhook.md) (`appmixer.jira.projects.DeletedProjectWebhook`): Triggers when a project is deleted (Webhook). Additional scopes: `read:issue-type:jira`, `read:project:jira`, `read:project.property:jira`, `read:user:jira`, `read:application-role:jira`, `read:avatar:jira`, `read:group:jira`, `read:issue-type-hierarchy:jira`, `read:project-category:jira`, `read:project-version:jira`, `read:project.component:jira`.
- [New Project](https://connectors.appmixer.com/connector/appmixer.jira/4.0.5/component/appmixer.jira.projects.NewProject.md) (`appmixer.jira.projects.NewProject`): Triggers when a new project is created. Additional scopes: `read:issue-type:jira`, `read:project:jira`, `read:project.property:jira`, `read:user:jira`, `read:application-role:jira`, `read:avatar:jira`, `read:group:jira`, `read:issue-type-hierarchy:jira`, `read:project-category:jira`, `read:project-version:jira`, `read:project.component:jira`.
- [New Project Webhook](https://connectors.appmixer.com/connector/appmixer.jira/4.0.5/component/appmixer.jira.projects.NewProjectWebhook.md) (`appmixer.jira.projects.NewProjectWebhook`): Triggers when a project is created (Webhook). Additional scopes: `read:issue-type:jira`, `read:project:jira`, `read:project.property:jira`, `read:user:jira`, `read:application-role:jira`, `read:avatar:jira`, `read:group:jira`, `read:issue-type-hierarchy:jira`, `read:project-category:jira`, `read:project-version:jira`, `read:project.component:jira`.
- [Updated Project](https://connectors.appmixer.com/connector/appmixer.jira/4.0.5/component/appmixer.jira.projects.UpdatedProject.md) (`appmixer.jira.projects.UpdatedProject`): Triggers when a project is updated (Webhook). Additional scopes: `read:issue-type:jira`, `read:project:jira`, `read:project.property:jira`, `read:user:jira`, `read:application-role:jira`, `read:avatar:jira`, `read:group:jira`, `read:issue-type-hierarchy:jira`, `read:project-category:jira`, `read:project-version:jira`, `read:project.component:jira`.

## Actions (14)

- [Get Instance Info](https://connectors.appmixer.com/connector/appmixer.jira/4.0.5/component/appmixer.jira.core.GetInstanceInfo.md) (`appmixer.jira.core.GetInstanceInfo`): Retrieves information about the Jira instance including version, build details, server time, and health status. This component is useful for getting basic server information and verifying instance connectivity. Additional scopes: `read:jira-work`.
- [Make Api Call](https://connectors.appmixer.com/connector/appmixer.jira/4.0.5/component/appmixer.jira.core.MakeApiCall.md) (`appmixer.jira.core.MakeApiCall`): Performs an arbitrary authorized API call to the Jira API. Additional scopes: `read:jira-work`.
- [Assign Issue](https://connectors.appmixer.com/connector/appmixer.jira/4.0.5/component/appmixer.jira.issues.AssignIssue.md) (`appmixer.jira.issues.AssignIssue`): Assign an Issue to an Assignee. Additional scopes: `write:jira-work`, `read:jira-work`.
- [Create Issue](https://connectors.appmixer.com/connector/appmixer.jira/4.0.5/component/appmixer.jira.issues.CreateIssue.md) (`appmixer.jira.issues.CreateIssue`): Creates an issue on Jira. Additional scopes: `write:jira-work`, `read:jira-work`.
- [Delete Issue](https://connectors.appmixer.com/connector/appmixer.jira/4.0.5/component/appmixer.jira.issues.DeleteIssue.md) (`appmixer.jira.issues.DeleteIssue`): Delete an issue in Jira. Additional scopes: `write:jira-work`.
- [Find Issues](https://connectors.appmixer.com/connector/appmixer.jira/4.0.5/component/appmixer.jira.issues.FindIssues.md) (`appmixer.jira.issues.FindIssues`): Find issues by JQL query. Additional scopes: `read:jira-work`.
- [Get Issue](https://connectors.appmixer.com/connector/appmixer.jira/4.0.5/component/appmixer.jira.issues.GetIssue.md) (`appmixer.jira.issues.GetIssue`): Get a selected Issue using its ID. Additional scopes: `read:jira-work`.
- [Find Issue Transitions](https://connectors.appmixer.com/connector/appmixer.jira/4.0.5/component/appmixer.jira.issues.GetIssueTransitions.md) (`appmixer.jira.issues.GetIssueTransitions`): Get a selected Issue using its ID. Additional scopes: `read:jira-work`.
- [Update Issue](https://connectors.appmixer.com/connector/appmixer.jira/4.0.5/component/appmixer.jira.issues.UpdateIssue.md) (`appmixer.jira.issues.UpdateIssue`): Update an issue. Additional scopes: `write:jira-work`, `read:jira-work`.
- [Create Project](https://connectors.appmixer.com/connector/appmixer.jira/4.0.5/component/appmixer.jira.projects.CreateProject.md) (`appmixer.jira.projects.CreateProject`): Create a project in Jira. It does not work on Cloud Free Plan accounts. Additional scopes: `write:project:jira`, `read:project:jira`.
- [Delete Project](https://connectors.appmixer.com/connector/appmixer.jira/4.0.5/component/appmixer.jira.projects.DeleteProject.md) (`appmixer.jira.projects.DeleteProject`): Delete a Jira project. Additional scopes: `delete:project:jira`, `read:project:jira`.
- [Get Project](https://connectors.appmixer.com/connector/appmixer.jira/4.0.5/component/appmixer.jira.projects.GetProject.md) (`appmixer.jira.projects.GetProject`): Get a selected project using its ID. Additional scopes: `read:issue-type:jira`, `read:project:jira`, `read:project.property:jira`, `read:user:jira`, `read:application-role:jira`, `read:avatar:jira`, `read:group:jira`, `read:issue-type-hierarchy:jira`, `read:project-category:jira`, `read:project-version:jira`, `read:project.component:jira`.
- [List Projects](https://connectors.appmixer.com/connector/appmixer.jira/4.0.5/component/appmixer.jira.projects.ListProjects.md) (`appmixer.jira.projects.ListProjects`): Get a list of projects. Additional scopes: `read:issue-type:jira`, `read:project:jira`, `read:project.property:jira`, `read:user:jira`, `read:application-role:jira`, `read:avatar:jira`, `read:group:jira`, `read:issue-type-hierarchy:jira`, `read:project-category:jira`, `read:project-version:jira`, `read:project.component:jira`.
- [Update Project](https://connectors.appmixer.com/connector/appmixer.jira/4.0.5/component/appmixer.jira.projects.UpdateProject.md) (`appmixer.jira.projects.UpdateProject`): Update a Jira project. It does not work on Cloud Free Plan accounts. Additional scopes: `read:issue-type:jira`, `read:project:jira`, `read:project.property:jira`, `read:user:jira`, `read:application-role:jira`, `read:avatar:jira`, `read:group:jira`, `read:issue-type-hierarchy:jira`, `read:project-category:jira`, `read:project-version:jira`, `read:project.component:jira`, `write:project:jira`, `write:project.avatar:jira`.

## Changelog

### 4.0.5

- Security: removed the deprecated request / request-promise libraries (SSRF advisory with no fix). Jira API calls now go through the platform HTTP client; error messages still carry the Jira response body.

### 4.0.4

- Quote CSV cells that hold a comma, a double quote or a line break and map cells by header column when exporting results to a file.

### 4.0.3

- Security: upgraded moment to 2.31.0 (path traversal and ReDoS advisories).

### 4.0.2

- MakeApiCall: Request Headers and Query Parameters set in the Designer are now sent. They were silently dropped: the key-value field stores its rows as a JSON object string, which the component did not parse.

### 4.0.1

- Fixed a crash when a Find/List component saved an EMPTY result set to a CSV file — the header row was built from the first record without checking there was one, so a search that legitimately matched nothing failed the flow instead of writing an empty file.

### 4.0.0

- Breaking changes: existing Jira connections must be re-authenticated after this update due to changed OAuth scopes.
- CreateProject, UpdateProject, DeleteProject: narrow scope from the broad manage:jira-configuration to manage:jira-project (the dedicated project-admin scope, sufficient for create/update/delete project).
- UpdateProject: add read:jira-work for the GET project fallback used when permission-scheme updates are forbidden on Free plans.
- Added MakeApiCall component for performing arbitrary authorized API calls to the Jira API.

### 3.1.0

- Added test() (Flow Test Mode) to all triggers: NewIssue, UpdatedIssue, NewProject, DeletedProject (polling) and NewIssueWebhook, UpdatedIssueWebhook, DeletedIssue, NewProjectWebhook, UpdatedProject, DeletedProjectWebhook. Shared jira-commons.fetchLatestIssue/fetchLatestProject reuse the same search/project requests as tick() (newest-first, no `> now` baseline); webhook variants reshape the record into the webhook payload via toWebhookShape.

### 3.0.1

- Added output examples to component schemas.

### 3.0.0

- Breaking changes: existing Jira connections must be re-authenticated after this update due to changed OAuth scopes.
- Fix OAuth scopes: auth.js now only requests offline_access, component-specific scopes are declared per component.
- DeleteProject: fix scope from write:jira-work to manage:jira-configuration.
- GetInstanceInfo: add missing scope read:jira-work.
- ListTemplates: remove unnecessary scope (private component, no API call).

### 2.0.3

- CreateIssue, IssueMetadata: add pagination support for createmeta endpoints — required fields (e.g. Summary) were missing in inspector when projects had more fields than the default page size (50).

### 2.0.2

- Create Issue, Update Issue: fix support for custom fields.

### 2.0.0

- (breaking change) Updated FindIssues, NewIssue, and UpdatedIssue components to use the new JQL enhanced search API endpoint instead of the deprecated /rest/api/3/search endpoint.

### 1.4.0

- Added new component - Get Instance Info: Retrieves information about the Jira instance.
- Use svg icon instead of png in all components.

### 1.3.0

- Auth: when creating a new connection, there is an option to specify the JIRA Cloud Site.

### 1.2.2

- CreateProject, UpdateProject, AssignIssue: fixed "Cannot read properties of undefined (reading 'includes')" error.

### 1.2.1

- Auth: remove npm dependencies from the auth.js.

### 1.2.0

- Find Issue Transitions: The new component allows you to find available issue transitions either by searching for them by name or by listing all available transitions.

### 1.1.0

- UpdateIssue: add update status field. The status can only be selected from the list of available options after entering the Issue ID or Key, as the status is dependent on the specific issue. Alternatively, you may directly enter the status ID.

### 1.0.8

- CreateProject: updated tooltip.
- CreateIssue, UpdateIssue: Assignee field now only display assignees available for the project in the selection. The endpoint used for creating fields of both components has been updated to no longer use the deprecated one.

### 1.0.7

- UpdatedIssue: fix onTick error.

### 1.0.6

- NewIssue, UpdatedIssue: now works with timezones correctly.

### 1.0.5

- Fixed issue with JIRA API scopes when obtaining reporters.

### 1.0.4

- Fixed issue with JIRA API scopes when obtaining labels.

### 1.0.3

- Updated links to JIRA documentation to open in new tab.

### 1.0.2

- IssueMetadata fix.

### 1.0.0

- Initial version
