Skip to main content

Integrating Manta with Jira

This guide explains how to integrate the app with Jira in order to automatically create Jira issues directly from the app.

Prerequisites​

Before integrating the Manta with Jira, ensure you have:

  • Running app instance (local or deployed)
  • An active Jira Cloud account
  • An existing Jira Space where issues will be created

Integration Steps

Step 1: Create a Jira API Token​

  1. Go to Atlassian Account and sign in.
  2. Open Profile → Manage your account
  3. Navigate to Security
  4. Select API tokens
  5. Click Create API token
  6. Copy the generated token

This token will be used as the JIRA_API_KEY in the app configuration.

Step 2: Get the Jira Space Key​

  1. Open Jira and navigate to your space
  2. Go to Space settings
  3. Select Details
  4. Copy the Space key (e.g. SUP, OPS, TEST)
info

Jira Cloud does not support account passwords for API access.

The space key is a short, unique identifier used in Jira issue IDs (e.g., SUP-123) and corresponds to JIRA_SPACE_KEY.

warning

Access to space settings may be restricted to space administrators or users with the appropriate permissions.

Step 3: Set up permissions​

If the account you are using (username + API token) is not a space administrator, make sure the space permissions are configured correctly.

The Jira space should be set to Private access. This means:

  • Only users who are members of the space can access it.
  • Users who are not part of the space cannot view or interact with it.
  • Only space members can make changes (such as creating or updating issues).

If you are not part of the space, a space administrator must:

  • Add you as a space member
  • Assign you an appropriate role (e.g. Developer)

This is required to allow you to create issues and perform other space actions.

Step 4:Create an Issue Type (Optional)​

This step is optional. You can use an existing issue type in your Jira space; creating a new one is not required.

  1. In your Jira space, go to Space settings
  2. Open Issue types
  3. Create a new issue type or select an existing one (e.g. Bug, Task, Support Request)

This value corresponds to JIRA_ISSUE_TYPE.

Step 5:Create Organization field (Optional)​

  1. In your Jira space, go to Space settings
  2. Open Issue types → select the issue type you are using
  3. Create a new custom field of type Label
  4. Retrieve the custom field ID:
  5. Use the custom field ID (e.g., customfield_10132) in your code as the JIRA_ORGANIZATION_FIELD, and set its value to your organization name.

Step 6: Configure Jira in app​

To enable Jira integration, configure the following environment variables:

ENABLE_JIRA_SUPPORT=true

JIRA_URL=""
JIRA_USERNAME=""
JIRA_API_KEY=""

JIRA_SPACE_KEY=""
JIRA_ISSUE_TYPE=""
JIRA_ISSUE_SUMMARY=""

JIRA_ORGANIZATION_FIELD=""
JIRA_ORGANIZATION_VALUE=""

  • JIRA_URL Base URL of your Jira Cloud instance (e.g. https://your-company.atlassian.net)
  • JIRA_USERNAME Email address associated with the API token
  • JIRA_API_KEY Jira API token (not your actual password)
  • JIRA_SPACE_KEY Jira space key
  • JIRA_ISSUE_TYPE Type of issue to create (e.g. Bug, Task, Story)
  • JIRA_ISSUE_SUMMARY Default issue summary/title created via the application
  • JIRA_ORGANIZATION_FIELD Custom field key used for organization mapping (e.g. customfield_10002)
  • JIRA_ORGANIZATION_VALUE Value assigned to the organization field when creating the issue