# Jira Salesforce integration Integrating Salesforce with Jira using Getint improves team collaboration. Real-time data sync allows the management of customer requests, tasks, bugs, and projects without manual input. This integration supports Salesforce Lightning, Classic, and various Jira deployments, including Cloud, Data Center, and Service Management.

Check out our Salesforce integration app on the Atlassian Marketplace

### **Salesforce-Jira Licensing Model** The **Salesforce-Jira licensing model** with Getint is designed to accommodate different integration needs. Here’s an overview: #### **Standard Licensing** * A Getint license is only required on Jira, allowing seamless data synchronization between Salesforce and Jira. * This makes setup simpler and faster, without the need for additional configurations in Salesforce. #### **Flexible License** * For managed services companies or organizations looking to integrate four or more instances (regardless of whether they are the same or different tools), Getint offers a **Flexible License.** This custom license covers a specific number of connections (i.e., up to 10 instances) without restrictions on the tools involved. You can also swap the integrated tools while the license remains active, offering unparalleled flexibility. For more details on licensing, visit our [**Pricing Page**](https://docs.getint.io/billing-and-services/licensing)**.** ### **Requirements to Build Your Integration** * The **Getint app** must be installed in Jira. #### **Salesforce API Requirements** Salesforce requires API access for integration. API access is enabled by default in the following editions: * Enterprise Edition * Unlimited Edition * Performance Edition * Developer Edition API access is **NOT enabled** by default in: * Group Edition * Essentials Edition * Professional Edition {% hint style="info" %} If using a Salesforce edition without API access enabled, please contact Salesforce support or refer to the Salesforce Help & Training Community. {% endhint %} #### **Authentication and Access Requirements** * OAuth authentication is required to establish a secure connection between Salesforce and Jira. * Comments are attributed to the user who created the connection. Therefore, we recommend using dedicated Service Accounts for both instances. * Jira instances must have a dedicated user and an associated API token with permissions to read, write, view, and modify the project. * **Personal Access Tokens** are required for Jira authentication. Learn more here: [Connection Guide](https://docs.getint.io/guides/quickstart/connection#salesforce). ### **Setting Up Your Salesforce-Jira Integration** #### **1. Access the** [**Getint**](https://marketplace.atlassian.com/apps/1223930/issue-sync-integration-for-jira-getint-issue-sync?hosting=cloud\&tab=overview) **App in Jira:** * Navigate to Jira, go to Apps, and select the Getint app (Salesforce integration for Jira in this case).

#### **2. Create Integration** Click **Create Integration** and select either: * **Continuous Sync** for ongoing synchronization. * **Migration** for a one-time data transfer.

#### **3. Generate a Jira API Token** * Log in to your Atlassian account and navigate to **Account Settings > Security**. * Generate an API token.

* Copy and securely store the token, as it will be used as the password for Jira Cloud. For detailed steps, refer to our guide [Connection](https://docs.getint.io/guides/quickstart/connection#jira). #### **4. Create a connection to Jira and Salesforce and authorize Getint** **Jira Connection:** * Select the **Jira** app. Then enter your Jira instance **URL**, username, and Access token generated.

* Select the Jira project you want to synchronize and select **Connect**.

**Salesforce Connection:** * Select **Salesforce** and click **Create a Connection**. * Enter your Salesforce instance URL in the **URL** field and click **Next**.

* Assign a name to the connection and enter the **client\_id** and **client\_secret** credentials.

* **Add** the connection and select it. {% hint style="info" %} For detailed steps on configuring your **Salesforce credentials**, please refer to our guide [Connection](https://docs.getint.io/guides/integration-synchronization/jira-salesforce-integration/salesforce-oauth-authentication). {% endhint %} #### **5. Configure Type Mapping** * **Quick Build (Beta):** Use the Quick Build feature to automatically map fields and types between applications, simplifying the process.

* **Manual Mapping:** For greater control, manually map the types yourself. This approach lets you tailor the mapping to meet your specific needs. Click **+ Add type mapping** to add the types (Case, Task, Bug, Epic, Story) by yourself. * **Story ↔ Case**

#### **6. Configure Field Mapping** * Select the fields to synchronize, such as **Title**, **Description**, **Assignees**, and **Custom** fields.

* Ensure synchronization flow is defined for each field, using the arrows and selecting **Apply**.

{% hint style="info" %} Some custom field types may not be supported. Please check our [Connectors Salesforce page](https://docs.getint.io/getting-started-with-the-platform/apps-connectors/salesforce) for a list of supported fields. If a field is missing or you need custom development, visit our [Help Center](https://getint.io/help-center). {% endhint %} #### **7. Configure Status Mapping** Ensure you are using the correct fields for each instance's status. * Navigate to the **Status Mapping** tab. * Use the dropdown menu to map Salesforce statuses to their Jira equivalents (e.g., **Open ↔ To Do**). * **Apply** the status mappings.

#### **8. How to Manage Comments & Attachments:** * Review the **Comments & Attachments** tab. These features are enabled by default but can be adjusted to meet your organization's needs.

* You can adjust the sync direction for comments and attachments to be bidirectional, **unidirectional to Jira**, or **unidirectional to Salesforce**. Also, you can completely disable comments and attachments if they are unnecessary or restricted in your organization. {% hint style="warning" %} Public/chatter comments and attachments do not automatically sync from Salesforce to Jira. To ensure they appear in Jira, update either the Salesforce ticket or the Jira ticket, depending on whether bidirectional sync is enabled. {% endhint %} #### **9. Filtering Option** Customize synchronization by applying filters: * After completing your integration, add filters to each app by clicking the filter icon next to its app icon. This will affect the corresponding side of the integration.

* Choose the filter scope: * **ALL items filter:** Rules will be verified for every item before synchronization. * **NEW items filter:** Rules will be verified only for newly created items that have not yet been synced. * **SYNCED items filter:** Rules will be verified for items that were already synced in the past. Add values for the filters and click **Apply**. For more details on how to use the filter, refer to our [Filtering Guide](https://docs.getint.io/getintio-platform/workflows/items-filtering).

**JQL Filtering (For Jira Side Only)** * In addition to the Item Filtering options mentioned above, Jira apps also support JQL (Jira Query Language) Filtering, allowing you to refine and customize which items are included in the sync. * Under the field Custom JQL, it is possible to provide a JQL, which will be the filter for your sync and appended to the one generated when searching for issues in Jira (i.e., status in (“In Progress”)).

* Name your integration and click on **Create** to save the integration.

#### **10. Test the Integration** * Create a test case in Salesforce and a test task in Jira. * Verify synchronization by performing actions like adding comments, attachments, or changing statuses. * Check logs in Getint to ensure the integration is working as expected. {% embed url="" %} #### **11. Duplicating Your Setup and Selecting Different Projects:** * Navigate to Workflows. * Click the three dots on the right and choose Duplicate.

* A side panel will appear. Enter a new name for the integration, which defaults to "copy" if the same projects are used. * In the dropdown menu, choose the projects to integrate. * For each side, click Connect, then Duplicate.

* Save the new integration. ### **Conclusion** At Getint, we're dedicated to providing exceptional support throughout your integration journey. Our team is committed to delivering the best customer experience. For any questions about this integration or assistance with the setup process, don't hesitate to open a ticket at our [Help Center](https://getint.io/help-center) or [Schedule a Demo](https://calendly.com/d/cpws-jb2-8xx/demo-call-all-team). We're here to help!