Atlassian Jira

Atlassian Jira — search, create, and manage issues, transitions, and projects via the Jira Cloud REST API.

Overview

Property	Value
Type	`http`
Authentication	`basic`
Category	Developer Tools

Configuration

Field	Type	Required	Description
`instance_url`	string	Yes	Jira Cloud instance URL (e.g. https://acmecorp.atlassian.net)
`email`	string	Yes	Atlassian account email
`api_token`	string	Yes	Atlassian API token

Available actions

Search Issues

Search for issues using JQL (Jira Query Language).


Endpoint	`POST /rest/api/3/search`
Method	`POST`

Get Issue

Retrieve a single issue by ID or key.


Endpoint	`GET /rest/api/3/issue/{issueIdOrKey}`
Method	`GET`

Create Issue

Create a new issue (bug, task, story, etc.).


Endpoint	`POST /rest/api/3/issue`
Method	`POST`

Update Issue

Update fields on an existing issue.


Endpoint	`PUT /rest/api/3/issue/{issueIdOrKey}`
Method	`PUT`

Transition Issue

Move an issue to a different workflow status.


Endpoint	`POST /rest/api/3/issue/{issueIdOrKey}/transitions`
Method	`POST`

Add Comment

Add a comment to an issue.


Endpoint	`POST /rest/api/3/issue/{issueIdOrKey}/comment`
Method	`POST`

List Projects

Retrieve a paginated list of projects visible to the user.


Endpoint	`GET /rest/api/3/project/search`
Method	`GET`

Get Transitions

Get available workflow transitions for an issue.


Endpoint	`GET /rest/api/3/issue/{issueIdOrKey}/transitions`
Method	`GET`

Example flow

name: zendesk-escalation-to-jira
description: Create a Jira issue when a Zendesk ticket is escalated, then notify Slack
trigger:
  connector: zendesk
  event: ticket.escalated

steps:
  - name: create-jira-issue
    action: jira.create-issue
    params:
      fields:
        project:
          key: SUP
        issuetype:
          name: Bug
        summary: "[Escalation] {{ trigger.payload.ticket_subject }}"
        description:
          type: doc
          version: 1
          content:
            - type: paragraph
              content:
                - type: text
                  text: "Escalated from Zendesk ticket #{{ trigger.payload.ticket_id }}"
            - type: paragraph
              content:
                - type: text
                  text: "{{ trigger.payload.ticket_description }}"
        priority:
          name: High

  - name: add-zendesk-link
    action: jira.add-comment
    params:
      issueIdOrKey: "{{ steps.create-jira-issue.output.key }}"
      body:
        type: doc
        version: 1
        content:
          - type: paragraph
            content:
              - type: text
                text: "Zendesk ticket: "
              - type: text
                text: "{{ trigger.payload.ticket_url }}"
                marks:
                  - type: link
                    attrs:
                      href: "{{ trigger.payload.ticket_url }}"

  - name: notify-slack
    action: slack.send-message
    params:
      channel: "#escalations"
      text: ":rotating_light: Zendesk escalation created as {{ steps.create-jira-issue.output.key }} — {{ trigger.payload.ticket_subject }}"