FAQ for Jira
      Back to home
      1. Help Center
      2. Atlassian Jira Integration Docs
      3. FAQ for Jira

      What Permissions are Required for Jira Users?

      Connecting Jira to Unito is quick and easy with OAuth2. Other methods, however, require specific permissions. Below are several options and what's needed for each.

      In this article:

      Unito can only perform the same actions as the user who connects it to their Jira account.  So in order for your Unito flow to create an issue or task, change a status, or leave a comment, you must have permission to perform that action too.

      General Jira Permissions

      In general, you must be able to:

      • Login to Jira
      • Browse users and groups (Required for managing assignees, reporters, and commenters involved in your Unito workflows)

      If you're connecting via OAuth2, then your workspace members don't require specific permissions to create a Unito flow.

      Details on how to set permissions in Jira can be found in the Atlassian Jira Knowledge Base, and information about managing permissions can be found here.

      Here's our step-by-step guide on how to configure Unito for Jira access.

       

      Authorization Methods

      OAuth2 is the most secure and reliable method of connecting Jira to Unito. It allows for granular control over permissions and simplifies setup without requiring high-level admin access. We recommend using OAuth2 for connecting your cloud-based Jira accounts.

      Jira Cloud OAuth2

      Other methods

      There are other authorization methods for connecting Jira to Unito, but they require additional steps and permissions in order to sync properly with Unito:

      • API Key: Requires certain Jira administration permissions to create the key.
      • OAuth1: May have limitations for some actions and generally requires a Jira administrator.
      • Username and Password: Least secure method and often requires Jira administrator permissions. 

      Important: If possible, create a Jira service account (also known as a bot user), for the Unito integration. This improves security and makes managing the integration easier.


      Permissions required to sync with Jira

      Global Jira permissions

      • Login to Jira
      • Browse Projects
      • Administer Projects

      Why do we need these?

      • These permissions are necessary for Unito to communicate with Jira and perform actions like creating issues, making updates, and adding comments.
      • Using webhooks (enabled by these permissions) allows for smoother and more efficient synchronization between Jira and your other connected tools.

      The following permissions are needed if you want to have webhooks enabled. If not, you can still sync with Unito, but your flow won’t update issues in real-time.

      Project permissions

      		 Issue permissions

      • View Development Tools

      • View Read-Only Workflow

      • Assignable User
      • Assign Issues
      • Close Issues
      • Create Issues
      • Edit Issues
      • Assignable User
      • Assign Issues
      • Close Issues
      • Create Issues
      • Edit Issues
      • Link Issues
      • Modify Reporter
      • Move Issues
      • Resolve Issues
      • Schedule Issues
      • Transition Issues 

      Comments permissions

      		 Time tracking permissions
      • Add Comments
      • Edit All Comments (if you want to allow Unito to edit comments)
      • Edit Own Comments
      • Work On Issues
      • Edit All Worklogs
      • Edit Own Worklogs 

      Attachments permissions

      Voters & watchers permissions
      • Create Attachments (if you want Unito to be able to attach files to issues)
      • View Voters and Watchers (if you want Unito to keep track of voters and watchers on Jira issues)

      Additional Resources for Jira Users: