Salesforce
Create or link to issues from cases. Linear's Salesforce integration is available as an add-on to our Enterprise plan.
Overview
Salesforce users—whether or not they use Linear—can link cases to existing issues and projects or create new issues using a Linear template.
Real-time updates ensure Salesforce users stay informed of issue/project status and priority changes as they happen, streamlining collaboration between teams.
Configure
Contact us
Please reach out to sales@linear.app to purchase licenses for this integration. Once purchased, assign them to Salesforce users to enable them to access the integration.
Configure from Linear
- Navigate to Settings > Integrations > Salesforce
- Click Enable
- Copy the URL from any page in your Salesforce installation
- Paste the URL in the modal in Linear settings
Configure from Salesforce
- Install the Linear integration from the Salesforce Marketplace
- Find the Linear Development app in the Salesforce App Launcher
- Click Login with Linear
- Select the Linear workspace you want to connect
- Confirm the integration between Salesforce and Linear
Enable the Linear component
- Navigate to a case detail page (commonly in Service Cloud or Support Cloud)
- Edit the case detail page
- Find Linear in the list of custom components
- Place the component in the location of your choice on the page
Permissions
Three permission sets will become available in Salesforce:
| Role | Function |
|---|---|
| Linear Admin | Has admin permissions in Linear and allows full access and configuration rights |
| Linear Create Issues | Can create and/or link issues and/or projects |
| Linear Link Only | Can only link existing issues. This is useful for large support teams who want more control over issues being created in order to limit noise in Linear. |
Settings
Restrict issue visibility
Once enabled, only Linear issues that were created from or previously linked to Salesforce can be found when searching from the Linear component. This allows teams with privacy concerns to reduce the scope of visible issues in the Salesforce workspace.
Internal notes
Automatically notify your team in Salesforce when an issue linked to a case changes to any status. Changes will be added to the All updates section of a case.
Automatic case reopening
When the linked Linear issue is completed or canceled, you can automate reopening the case to the case status of your choice. This signals your team to follow up with customers.
Case statuses are customizable. If a new case status is added, visiting the Salesforce integration's page in Linear settings will reflect the addition.
Templates
Once a template has been created in Linear, click the + icon to make a template available to Salesforce.
Mapping attributes from Salesforce to Linear
When Customer Requests is enabled, creating issues from a Salesforce case will create new Customers in Linear as needed. The customer request added to the created issue contains the case description.
Customers support attributes you can use to group, order, and filter for data in Linear. For example, filter issues by the tier of the Customer who requested them, order projects by the associated sum of attributed customer revenue, and more. To bring this data into Linear from Salesforce, set the desired mapping between Salesforce account properties and Customer attributes in Linear in Settings > Customer Requests.
You can set mappings with any property you use on Salesforce accounts, as long as the data type is allowable:
| Customer attribute | Allowed data type |
|---|---|
| Owner | String (email address) |
| Tier | String |
| Status | String |
| Revenue | Number |
| Size | Number |
If you're using lookup fields in Salesforce and wish to map to these in Linear, consider using formula fields as described in the FAQ.
Using the integration
Create a new issue
- From a case's details, click Create issue
- Select a template. All issues created by this integration use templates to drive consistency.
- Include a title
- Write a new issue description, or turn on the Include case description toggle to automatically insert the case description into the Linear issue description. The case description will appear in Linear as the Customer Request attached to the issue.
Link cases to existing issues or projects
- Click Link issue or project (depending on permission levels)
- Search for the issue or project and confirm
Link to cases from Linear
You can also link a Linear issue to a case by pasting the case's URL into the Linear issue as a link attachment with Control + L.
Synced details
Status and priority
When an issue is linked to a case, a reference to that issue appears in the Salesforce integration. The linked issue's status and priority are always current.
User account attribution
If a Salesforce user is also a Linear user, their name will be displayed as the issue creator in relevant issue activity sections. If the user does not have a Linear account, the issue creator displays as “User User” (the name of the Salesforce developer account) and the email of the Salesforce user who created or linked the issue.
Customer information
Linear syncs customer information from the Salesforce workspace. Modify attribute mapping as discussed in Mapping attributes above.
Triage rules
Using the Salesforce integration concurrently with Triage rules offers tools to direct how issues are routed after they're created from Salesforce. You can create rule conditions using properties of the Salesforce Case specifically, along with the normal set of filterable issue data in Linear. Triage rules can set an issue's team, status, assignee, label, project, and priority.
FAQ
The case will reopen in Salesforce as the linked issue has been canceled. We do not merge Salesforce cases. If desired you may link the reopened case to the canonical issue and re-close the case.
Suppose in Salesforce you have a field called "account owner"; an owner ID with a lookup to the user email. This would not work by default in our attribute mapping, as the owner field in Linear requires an email address.
You can work around this by using a formula field. To do so, create a new custom field of type formula. Clicking into "Advanced Formula" will help you build the formula you need.
In this scenario, a formula field for account.owner returning an email address can be used to map between Linear's Customer owner and the necessary value in Salesforce.
Linear data living inside of Salesforce (like which customers have the most issues created from within Salesforce) can be queried directly with SOQL. This can be used to run analyses like returning issues linked to cases, or building custom dashboards within Salesforce.