Jira Connection

The Jira connection allows your Horizon agents to manage issues, projects, boards, and sprints in Atlassian Jira Cloud. Agents can create issues, update statuses, add comments, and query project data.

Prerequisites

Before connecting Jira to Horizon, ensure you have:

• A Jira Cloud instance (Jira Software, Jira Service Management, or Jira Work Management).
• Jira Administrator or Site Administrator access to approve third-party OAuth applications.
• The URL of your Jira Cloud instance (e.g., https://yourcompany.atlassian.net).

Note

Horizon connects to Jira Cloud only. Jira Server and Jira Data Center (self-hosted) are not supported at this time.

Setting Up the Connection

1. Navigate to Workspace > Connections and click + Add Connection.
2. Select Jira from the integration list.
3. Click Authorize with Atlassian. You will be redirected to Atlassian’s authorization page.
4. Sign in with your Atlassian account.
5. Select the Jira site you want to connect if you have access to multiple sites.
6. Review the permissions and click Accept.
7. You will be redirected back to Horizon with the status set to Connected.

Permissions and Scopes

Horizon requests the following Atlassian OAuth 2.0 (3LO) scopes:

• read:jira-work — read project and issue data including fields, comments, and worklogs.
• write:jira-work — create and update issues, add comments, log work, and transition statuses.
• read:jira-user — look up user information for assigning issues.
• manage:jira-project — manage project settings and components (optional, for advanced use cases).

What Agents Can Do

With the Jira connection, agents can:

• Create issues — file new bugs, stories, tasks, or epics with full field population including summary, description, priority, labels, and assignee.
• Update issues — change status, priority, assignee, and custom fields. Move issues through workflow transitions.
• Add comments — post comments on issues with formatting and @mentions.
• Search with JQL — query issues using Jira Query Language for advanced filtering.
• Manage sprints — view sprint contents, move issues between sprints, and check sprint progress.
• Read project data — list projects, boards, components, and versions.
• Track time — log work entries against issues.

Tip

Agents can use JQL to build powerful queries. For example, an agent could be instructed to “find all high-priority bugs assigned to me that are due this week” and it will translate that to the appropriate JQL query.

Connection Settings

After connecting, configure these options from the connection detail panel:

• Default project — the Jira project agents use when creating issues without a specified project.
• Default issue type — the issue type (e.g., Task, Story, Bug) used by default.
• Field mappings — map custom Jira fields to agent-friendly names.
• Workflow mappings — define which workflow transitions agents are allowed to perform.

Troubleshooting

Issue	Resolution
”User does not have permission”	Verify the authorizing user has the required project-level permissions in Jira.
Cannot find a project	Ensure the project exists, is active, and the connected user has access to it.
Custom fields not recognized	Map the custom field in connection settings or reference it by its Jira field ID.
Connection shows Expired	Atlassian refresh tokens can expire after extended inactivity. Click Re-authorize.

Disconnecting

To remove the Jira connection, click Remove Connection in Horizon. To also revoke access from Atlassian, go to id.atlassian.com > Security > Connected Apps and remove Horizon.