Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This guide will help you set up a connection between Jira and Salesforce.

Which version are you using?

Cloud

  1. Go to Settings > Salesforce.

  2. In the sidebar, under Configuration, click Connections.

  3. At the Salesforce Connections screen, click +Add Connection.

...

  1. Image Added



  2. The New Connection dialog window will pop up.
    Enter a Connection Name, then click Add.

...

  1. Image Added



  2. The connection will be added to the Connection Name list but you'll notice it is Not Authorized

  3. Click Authorize.

...

  1. Image Added



  2. Select the environment type of your Salesforce instance, either Production or Sandbox.

  3. Click Authorize to authorize the connection.

...

  1. Image Added



    If you're not logged into Salesforce, the browser will load a new page and prompt you to enter your Salesforce credentials.

  2. If the authorization was successful, you can now import the compact layout fields from Salesforce. This will quickly pre-populate the objects and fields available through the connection.
    (warning) This step is optional, and you can always configure it later. Otherwise, click Import to proceed.

...

  1. Image Added
  2. If the authorization was successful, the Status will display Authorized.

...

  1. Image Added

Server

This is a two-part process:

  • You will first need to set an Integration User before you are able to create a Connection.

  • Then you will add the Connection to Salesforce.

Step 1: Select an integration user

(warning) An integration user must be a dedicated Jira user account specifically created for this purpose. See Setting up an integration user for more information.

  1. Go to Settings > Add-ons/Manage apps.

  2. In the sidebar, under Salesforce, choose Settings.

  3. At the Settings screen, choose an Integration User for the Salesforce Package so that it can call Jira APIs on their behalf.

...

  1. Image Added



  2. After selecting an Integration User, click Save.

Step 2: Add a new Connection

  1. In the sidebar under Salesforce, choose Connections.

  2. At the Salesforce Connections screen, click +Add Connection.
    Image Modified

  3. The New Connection dialog window will pop up.

  4. Enter a Connection Name, then click Add.

...

  1. Image Added



  2. The connection will be added to the Connection Name list but you'll notice it is Not Authorized

  3. Click Authorize under the Operations column.

...

  1. Image Added



  2. Select the environment type of your Salesforce instance, either Production or Sandbox.

  3. Click Authorize.

  4. You will be given a code and asked to enter it at https://login.salesforce.com/setup/connect.
    Image Modified

    Note
    iconfalse
    (warning) When logging in to Salesforce to enter the code, the current user who logs in will become the "Salesforce Integration User".


  5. Follow the instructions. Once completed, return to your Jira instance and click Authorize.

  6. If the authorization was successful, you can now import the compact layout fields from Salesforce.
    This will quickly pre-populate the objects and fields available through the connection you've just created.
    Image Modified

    (info) This step is optional, and you can always configure it later.
    Otherwise, click Import to proceed.

  7. If the authorization was successful, the Status will display Authorized.

What's next?

If you are using Jira Server:

If you are using a Jira Cloud: