Jira

Create and manage Jira issues and projects from your Spala flows.

Jira

The Jira addon integrates Atlassian Jira into your Spala flows. Create issues, update statuses, search with JQL, and automate your project management workflows.

Installation

1. Enable the Jira addon from the Addons panel
2. Create an API token at id.atlassian.com/manage-profile/security/api-tokens
3. Enter your Jira credentials in the addon configuration

Configuration

Available Steps

Create Issue

Creates a new Jira issue.

Update Issue

Updates fields on an existing Jira issue.

Search Issues (JQL)

Searches for issues using Jira Query Language.

Transition Issue

Changes the status of a Jira issue (e.g., move from "To Do" to "In Progress").

Example: Auto-Create Bug from Error

// Error handler flow

// Step 1: Create Issue (Jira addon)
// projectKey: 'APP'
// issueType: 'Bug'
// summary: '[Auto] Error in ' + vars.flowName + ': ' + vars.error.message
// description: 'Automatically created from error monitoring.\n\nFlow: ' + vars.flowName + '\nStep: ' + vars.stepName + '\nTime: ' + new Date().toISOString() + '\n\nStack trace:\n' + vars.error.stack
// priority: 'High'
// Output → vars.jiraIssue

// Step 2: Log
// 'Created Jira issue: ' + vars.jiraIssue.key

Example: Sprint Report

// GET /api/sprint-report

// Step 1: Search Issues (Jira addon)
// jql: 'project = APP AND sprint in openSprints() AND status = Done'
// fields: ['summary', 'assignee', 'status', 'story_points']
// Output → vars.completedIssues

// Step 2: Response
// { completed: vars.completedIssues.total, issues: vars.completedIssues.issues }

Jira API authentication uses Basic Auth with your email and API token. The addon handles the encoding automatically. Make sure the account associated with the token has the necessary project permissions.

Your Jira instance URL (e.g., "https://yourteam.atlassian.net").
Your Atlassian account email address.
API token from your Atlassian account settings.
The project key (e.g., 'PROJ').
Issue type: 'Bug', 'Task', 'Story', 'Epic', etc.
Issue title/summary.
Issue description (supports Atlassian Document Format or plain text).
Priority: 'Highest', 'High', 'Medium', 'Low', 'Lowest'.
Atlassian account ID of the assignee.
The issue key (e.g., 'PROJ-123').
Object of fields to update.
JQL query string (e.g., "project = PROJ AND status = Open").
Maximum results to return (default: 50).
Array of field names to include in results.
The issue key.
The transition ID (get available transitions from the Jira API).
Automatically created from error monitoring.\n\nFlow:
Addons Overview
/addons
Browse available addons
Installing Addons
/addons/installing
Enable and configure addons in your project