Jira Cloud Integration

DejaCode’s integration with Jira allows you to automatically forward Workflow Requests to Jira Issues. This behavior can be selectively applied to any Request Template of your choice.

Prerequisites

  • A Jira Cloud project that you want to integrate with DejaCode.

    Note

    The Jira project must have an editable workflow, it is recommended to choose Jira > Blank project template during project creation.

  • A Jira user account with sufficient permissions (at least Create Issues and Edit Issues) in that project.

Create “DejaCode Request” Work Type

Warning

This is required for the integration to function properly.

To create the custom work type in Jira:

  1. Navigate to your Project settings → Work types

  2. Click + Add work type

  3. Set the name to: DejaCode Request

  4. Click Create

Define Open/Closed Statuses

Warning

This is required for the integration to function properly.

To edit the workflow statuses in Jira:

  1. Navigate to Project settings → Work types

  2. Select the DejaCode Request work type

  3. Click Edit workflow

  4. Rename the TO DO status to OPEN, keep the To do status category

  5. Rename the DONE status to CLOSED, keep the Done status category

  6. Click Update workflow > Save

Jira API Token

To enable integration, you need a Jira Cloud API token and the associated user email.

  1. Generate a Jira API Token:

  2. Store Your Credentials Securely:

    • You will need both:

      • Your Jira user email (the one used to log into Jira)

      • The API token you just generated

Note

The API token is required for authenticating to the Jira Cloud REST API. If your Jira instance is hosted on-prem (Jira Server/Data Center), the integration may not be supported without further customization.

DejaCode Dataspace Configuration

To use your Jira credentials in DejaCode:

  1. Go to the Administration dashboard

  2. Navigate to Dataspaces, and select your Dataspace

  3. Scroll to the Jira Integration section under Configuration

  4. Enter:

    • Your Jira user email

    • The API token you generated

  5. Save the form

Activate Jira Integration on Request Templates

  1. Go to the Administration dashboard

  2. Navigate to Workflow > Request templates

  3. Create or edit a Request Template in your Dataspace

  4. Set the Issue Tracker ID field to your Jira base URL with project key, e.g.:

    https://YOUR-DOMAIN.atlassian.net/projects/PROJECTKEY
https://YOUR-DOMAIN.atlassian.net/jira/software/projects/PROJECTKEY/summary

    • This URL must point to your Jira Cloud instance

Once the integration is configured:

  • New Requests using this template will be automatically pushed to Jira

  • Field updates (like title or priority) and status changes (e.g. closed) will be synced

  • New Comments on a DejaCode Request will be propagated to the Jira Issue