Integration

Jira

Turn approved call outcomes into traceable Jira work for the team.

Description

AIM AI can be configured to create or update selected Jira issues after a defined conversation step. Projects, issue types, fields, transitions, assignees, comments, and work logs are confirmed before implementation.

Authentication

A Jira API token with basic authentication or an OAuth 2.0 connection is required.
Exact Jira sites, projects, permissions, and approved actions are confirmed during workflow scoping.

Supported Actions (6)

These are the operations this integration can perform after the required credentials and permissions are approved.

create_issue: Create new Jira issues
update_status: Transition issues between statuses
assign_issue: Assign issues to team members
log_work: Log time spent on issues
search_issues: Search and filter issues
add_comment: Add comments to issues

Examples

Use these representative payloads as a technical starting point, then replace the sample values with the approved workflow data.

Required Parameters:

Representative workflow configuration for Required Parameters:.

JSON

{
  "automationType": "jira",
  "nodeId": "jira-create-issue-001",
  "nodeParams": {
    "action": "create_issue",
    "params": {
      "apiKey": "YOUR_JIRA_API_TOKEN",
      "email": "user@example.com",
      "instanceUrl": "https://your-domain.atlassian.net",
      "project": {
        "key": "PROJ"
      },
      "issuetype": {
        "name": "Task"
      },
      "summary": "Fix login bug",
      "description": "Users cannot log in with their email addresses"
    }
  }
}

Example

Representative workflow configuration for Example.

JSON

{
  "automationType": "jira",
  "nodeId": "jira-update-status-001",
  "nodeParams": {
    "action": "update_status",
    "params": {
      "apiKey": "YOUR_JIRA_API_TOKEN",
      "email": "user@example.com",
      "instanceUrl": "https://your-domain.atlassian.net",
      "issueId": "PROJ-123",
      "transitionId": "21"
    }
  }
}

Assign by Email

Representative workflow configuration for Assign by Email.

JSON

{
  "automationType": "jira",
  "nodeId": "jira-assign-issue-001",
  "nodeParams": {
    "action": "assign_issue",
    "params": {
      "apiKey": "YOUR_JIRA_API_TOKEN",
      "email": "user@example.com",
      "instanceUrl": "https://your-domain.atlassian.net",
      "issueId": "PROJ-123",
      "assignee": {
        "emailAddress": "developer@example.com"
      }
    }
  }
}

With Comment and Start Time

Representative workflow configuration for With Comment and Start Time.

JSON

{
  "automationType": "jira",
  "nodeId": "jira-log-work-001",
  "nodeParams": {
    "action": "log_work",
    "params": {
      "apiKey": "YOUR_JIRA_API_TOKEN",
      "email": "user@example.com",
      "instanceUrl": "https://your-domain.atlassian.net",
      "issueId": "PROJ-123",
      "timeSpent": "2h 30m",
      "comment": "Fixed the bug and added unit tests",
      "started": "2024-01-15T10:00:00.000Z"
    }
  }
}

Multiple Filters

Representative workflow configuration for Multiple Filters.

JSON

{
  "automationType": "jira",
  "nodeId": "jira-search-issues-001",
  "nodeParams": {
    "action": "search_issues",
    "params": {
      "apiKey": "YOUR_JIRA_API_TOKEN",
      "email": "user@example.com",
      "instanceUrl": "https://your-domain.atlassian.net",
      "status": "In Progress",
      "priority": "High",
      "project": "PROJ",
      "maxResults": 50,
      "startAt": 0
    }
  }
}

Basic Comment

Representative workflow configuration for Basic Comment.

JSON

{
  "automationType": "jira",
  "nodeId": "jira-add-comment-001",
  "nodeParams": {
    "action": "add_comment",
    "params": {
      "apiKey": "YOUR_JIRA_API_TOKEN",
      "email": "user@example.com",
      "instanceUrl": "https://your-domain.atlassian.net",
      "issueId": "PROJ-123",
      "body": "This issue has been resolved in the latest release."
    }
  }
}

Success Response

Representative workflow configuration for Success Response.

JSON

{
  "success": true,
  "data": {
    "id": "10001",
    "key": "PROJ-123",
    "self": "https://your-domain.atlassian.net/rest/api/3/issue/10001"
  }
}

Error Response

Representative workflow configuration for Error Response.

JSON

{
  "success": false,
  "error": "Invalid parameters provided"
}