Set up a connection to Salesforce (Jira Cloud)

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:

Create a new connection

Establish the initial authorization between Jira and Salesforce.

  1. Select Apps from the left sidebar in Jira.

  2. Next to Connector for Salesforce and Jira, click Menu (Menu.png) > App settings.

    App settings option in the Connector menu.
  3. Under Connector for Salesforce and Jira, click Connections.

  4. Click +Connection.

    Connections page showing the Connection button.

     

  5. Enter a Connection name (for example, My connection).

    Connection name field in the new connection form.

     

  6. Select Production or Sandbox as your Salesforce environment.

  7. Click Authorize and continue to authenticate with Salesforce.

    Salesforce connection form showing the authorize and continue button.

     

    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. 

  1. Select the checkboxes for the Salesforce object types you want to import (for example, Case, Account, and Opportunity).

    Salesforce object types available for import.

     

     

  2. Click Save and continue to finalize the setup.
    Your new connection now appears in your Connections list with the AUTHORIZED status.

    Authorized Connection

     

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.

  1. Follow the next steps to set up bidirectional sync in Salesforce and bindings to complete your configuration.

Next steps