Jira connection

After installing the Intercom app, it must be connected to Jira. This connection consists of two components:

• the Jira site that you would like to connect to your Intercom workspace, and

• the Jira user used by the Intercom app to read and write information to and from the Jira site - we refer to this as the Intercom app user or simply the app user.

This page describes these two elements of the Jira connection.

Jira site

Each installation of the Intercom app is connected to a single Jira site. The Jira site is selected during the app installation process and can only be changed by uninstalling and re-installing the app.

App user

Any operation in the Intercom app that involves interaction with Jira (e.g., create a work item or retrieve available Jira spaces) will be executed by the app user. The app user is the Jira user who was logged in to Jira when the Intercom app was installed and the connection to Jira was authorized.

While not strictly necessary, we do recommend setting up a dedicated Jira user for the Intercom app. You may call this user Intercom app or anything else you like. Benefits of setting up a dedicated user for the Intercom app include:

• Work items created via the Intercom app have a generic user (the app user) as the work item reporter.

• You can fine-tune and control access to Jira resources by configuring permissions of the app user (see Restricting app access for more details).

You can find the currently configured app user in your app by following the guide on inspecting app information. If you would like to change the Intercom app user, follow the steps on Changing the Intercom app user.