Last updated Feb 29, 2024

Integrating with Jira Service Management Cloud

Welcome to Jira Service Management development! This overview will cover everything you need to know to integrate with Jira Cloud. This includes the Atlassian Connect framework, which is used to integrate with Atlassian Cloud applications, as well as Jira Service Management features and services that you can use when building an app.

Hello world

If you already know the theory and want to jump straight into development, read our [Getting started guide](../getting-started) to build your first Jira Cloud app.

What is Jira Service Management?

Jira Service Management is primarily used as a service solution, from asset management to DevOps. A diverse range of IT teams use Jira Service Management, including support Management teams, operations teams, and more. With over 15,000 of these teams using Jira Service Management, there's plenty of potential to extend it. Jump in and get started!

If you haven't used Jira Service Management before, check out the product overview for more information.

Jira Service Management Cloud and Atlassian Connect

If you want to integrate with any Jira Cloud product, including Jira Service Management Cloud, then you should use Atlassian Connect. Atlassian Connect is an extensibility framework that handles discovery, installation, authentication, and seamless integration into the Jira UI. An Atlassian Connect app could be an integration with another existing service, new features for Jira, or even a new product that runs within Jira.

If you haven't used Atlassian Connect before, check out the Getting started guide. This guide will help you learn how to set up a development environment and build a Jira Cloud app.

Building blocks for integrating with Jira Service Management Cloud

The three building blocks of integrating with Jira Service Management are the REST API, webhooks, and modules.

Jira Service Management Cloud REST API

The Jira Service Management Cloud REST API lets your app communicate with Jira Service Management Cloud. For example, using the REST API, you can retrieve a queue's requests to display in your app or create requests from phone calls.
See the Jira Service Management Cloud REST API reference for details.
Note, Jira Service Management is built on the Jira platform, so you can also use the Jira Cloud platform REST API to interact with Jira Service Management Cloud.

Webhooks and automation rules

Apps and applications can react to conditions/events in Jira Service Management via automation rules. You can implement an "automation action" that performs actions in a remote system as part of an automation rule. An automation rule can also be configured to fire a webhooks that notifies your app or application.
For more information, see Automation webhooks.

Jira Service Management modules

A module is simply a UI element, like a tab or a menu. Jira Service Management UI modules allow apps to interact with the Jira Service Management UI. For example, your app can use a Jira Service Management UI module to add a panel to the top of customer portals.
For more information, see About Jira modules.

Jira Service Management Cloud and the Jira platform

Jira Service Management is an application built on the Jira platform. The Jira platform provides a set of base functionality that is shared across all Jira applications, like issues, workflows, search, email, and more. A Jira application is an extension of the Jira platform that provides specific functionality. For example, Jira Service Management adds customer request portals, support queues, SLAs, a knowledge base, and automation.

This means that when you develop for Jira Service Management, you are actually integrating with the Jira Service Management application as well as the Jira platform. The Jira Service Management application and Jira platform each have their own REST APIs, webhook events, and web fragments.

Read the Jira Cloud platform documentation for more information.

Looking for inspiration?

If you are looking for ideas on building the next Jira Service Management Cloud integration, the following use cases and examples may help.

Here are some common Jira Service Management use cases:

  • Support help desk: An easy way to provide support to anyone in the organization with IT requests such as hardware (laptop) requests, or software requests.
  • ITSM/ITIL: More advanced IT teams want to use a service solution to support ITSM and ITIL processes, including incident, problem, and change management.
  • Asset management: IT teams want to discover, control, monitor, and track key IT assets such as hardware and servers.
  • DevOps: Developer, Operations, and IT teams can use Jira Service Management to collaborate together and solve problems faster.
  • Business teams: Finance and HR teams may want to use Jira Service Management to collect requests from anyone in the organization.

Here are a few examples of what you can build on top of Jira Service Management:

  • Customer portal customization -- Jira Service Management provides an intuitive customer portal that makes it easy for non-technical end users to interact with service teams like IT and support. By extending this, you can build a completely tailored interface for the customer portal that matches your company's branding.
  • Collect requests outside of Jira Service Management -- Build functionality to create requests on behalf of customers in any number of ways. For example, integrate it into the support section of your website, or have a get help menu on your mobile app, or hook up alerts from a system monitoring tool to create incidents in Jira Service Management.
  • SLA integration -- Jira Service Management introduces the notion of service level agreements (SLAs) by letting teams accurately measure and set goals based on time metrics, e.g. time to assign, time to respond, time to resolution. With the Jira Service Management REST API, you can now get detailed SLA information and create your own reports.
  • Telephony integration -- Create requests based on incoming voice calls by integrating your telephony system with Jira Service Management, via the REST API.
  • Supplement request information -- Add information about assets, the customer, or other relevant information to requests to make it easier for agents to solve problems and close requests.

Next steps

Ready to get hands-on with Jira Cloud development? Read our Getting started guide to learn how to set up a development environment and build an app.

These resources will also help you start developing:

Rate this page: