Set up a connection to Salesforce (Jira Cloud)
A connection links a Jira instance to a Salesforce org, allowing the two systems to exchange data. Once set up, work items and records can be associated and kept in sync across both platforms without manual copying.
Before you start
Before you start, make sure you:
Have administrator rights in Jira - only administrators can set up the integration.
Create a new connection
Establish the initial authorization between Jira and Salesforce.
Select Apps from the left sidebar in Jira.
Next to Connector for Salesforce and Jira, click Menu (
) > App settings.
Under Connector for Salesforce and Jira, click Connections.
Click +Connection.
Enter a Connection name (for example, My connection).
Select Production or Sandbox as your Salesforce environment.
Click Authorize and continue to authenticate with Salesforce.
If you're not logged into Salesforce, the browser loads a new Salesforce login page and prompts you to enter your Salesforce credentials.
When the authorization is successful, the Status changes to AUTHORIZED.
Make sure your Salesforce account has object and layout permissions. For details, see How to set object permissions in profiles for a Salesforce user? If authorization fails, you can click Retry authorization.
Import Salesforce object types and fields
Once authorization is complete, the Importing step opens. Here, you can import the compact layout fields from Salesforce. Decide on Salesforce object types you want to have available in Jira. Based on these settings, you can later associate and synchronize data. This quickly pre-populates the objects and fields available through the connection.
Select the checkboxes for the Salesforce object types you want to import (for example, Case, Account, and Opportunity).
Click Save and continue to finalize the setup.
Your new connection now appears in your Connections list with the AUTHORIZED status.
Later, you can always add more Salesforce objects and configure details for your connection (notifications, attachments, comments, query, presets, rich text). For details, see Configure connection settings.
Follow the next steps to set up bidirectional sync in Salesforce and bindings to complete your configuration.
Next steps
(Optional) Configure the connection's object access, sync rules, notifications, and defaults for how Jira work items and Salesforce records link and update. See Configure connection settings.
To enable bi-directional data sync and viewing Jira data in Salesforce, you need to set up your integration in Salesforce.
Before you can associate Jira work items with Salesforce records and synchronize them, bind a Jira space to a connection. See Bind a Jira Project space a Salesforce Connection.