Skip to main content
Matik Help Center home page Help Center
Matik Blog Case Studies
  1. Matik
  2. Building Templates
  3. Data Sources

Connecting to CRMs (Salesforce, Hubspot, Gainsight)

Salesforce (SFDC)

Matik connects to Salesforce through the Matik External Client App. Connecting takes two parts: a Salesforce admin installs and configures the app in Salesforce once, and then a Matik admin connects the data source in Matik.

Note: Matik is moving Salesforce connections from the older Matik Connected App to the External Client App. If you already have a Salesforce data source in Matik, see Moving an existing connection to the External Client App below.

Step 1: Install the Matik External Client App in Salesforce

A Salesforce admin installs the app once for your Salesforce org. Open this URL, replacing YourDomainName with your Salesforce domain:

https://YourDomainName.lightning.force.com/packagingSetupUI/ipLanding.app?apvId=04tak000000U9YvAAK

Then follow the prompts to install the package. For details on each install screen, see Salesforce's package installation documentation.

Step 2: Configure the app's policies

In Salesforce, go to Setup → External Client App Manager and open the Matik app. Matik's package controls the OAuth settings (callback URL, consumer key, and consumer secret), so you only manage the policies:

  • Permitted Users: Choose who can connect to Matik. If you restrict access to admin-approved users, assign the profiles or permission sets of everyone who will connect, including your integration user and, if your data source requires it, each end user who logs in.
  • IP relaxation, refresh token, and session policies: Review these against your org's security requirements. A refresh token policy that expires tokens quickly will make Matik ask users to reconnect more often.

Note: If you restrict access to admin-approved users and assign no one, nobody can connect Salesforce to Matik.

Step 3: Connect Salesforce in Matik

salesforce.png

  1. Go to the Data Sources page and click + Add New.
  2. Select Salesforce under Data Source Type and give the data source a name.
  3. Choose the Salesforce instance type, and whether end users must log in to Salesforce to use this data source when they create a presentation.
  4. If your browser is logged in to a Salesforce account you don't want connected to Matik, log out of it.
  5. Click Connect to Data Source. In the Salesforce window that opens, log in as the user you want Matik to connect as (usually an integration user), then click Allow.

mceclip0.png

The window closes and Salesforce is connected. To start pulling data from Salesforce, see Using Salesforce with Matik.

If the connection fails

If Salesforce shows an OAuth or access error when you click Allow, check with your Salesforce admin that:

  • The Matik External Client App is installed in the same Salesforce org you're logging in to.
  • The user you logged in as is permitted to use the app (Step 2).

Moving an existing connection to the External Client App

If you connected Salesforce to Matik through the older Matik Connected App, follow these steps in order to move to the External Client App. Your existing data source keeps working on the old Connected App until you reconnect it, and your templates and Dynamic Content stay attached, so you don't need to rebuild anything.

  1. Install and configure the External Client App in Salesforce, following Steps 1 and 2 above.
  2. Tell your Technical Account Manager it's installed. Matik then switches your account to the External Client App and lets you know when it's done. Wait for that confirmation before you continue.
  3. Test with a new data source (recommended). In Matik, add a new Salesforce data source and connect it as your integration user (Step 3). Create a test Dynamic Content that uses it and run Test. In Salesforce, check the user's Login History to confirm the login came through the Matik External Client App. Your existing data source is unaffected during this test.
  4. Reconnect your existing data source. Open your existing Salesforce data source in Matik and reconnect it, logging in as your integration user. The data source moves to the External Client App when you reconnect. Check Login History again and generate a presentation to confirm everything works.
  5. Have end users log in again, if needed. If Require end user to log in to access this data source is turned on for your data source, each end user must log in to Salesforce again so their own connection also moves to the External Client App.
  6. Clean up. Delete the test data source in Matik. Then, in Salesforce, revoke the old Matik Connected App's tokens and block or uninstall it. Don't do this until every step above is complete, or Matik and your end users will lose access to Salesforce.

Gainsight

Connecting to Gainsight is similar to connecting to Salesforce.  Note that Matik connects to Gainsight using Gainsight's Rest API.

First, navigate to the Data Sources page and click on “+ Add New." Select “Gainsight” under the “Data Source Type” field and give the data source a name. Then enter your Gainsight Base URL.

You have two options for authentication:

  • Access Key
  • OAuth2

Remember to test your connection and click “Add Data Source” to save.

Authenticate via Access Key

Select "Access via Access Key." Enter your Gainsight API key. This article explains how admins can generate the Gainsight API access key. 

If you would like to require your end users to log in to their Gainsight accounts before generating presentations in Matik, click the check box. 

gainsight_hc_article.png

Authenticate via OAuth2

Select "Access Via OAuth2." Fill out the required fields. This Gainsight documentation walks through the process.

HubSpot

To connect to HubSpot, navigate to the Data Sources page and click on “+ Add New." Select "HubSpot" from the “Data Source Type” dropdown and name your data source. If you would like to require your end users to log in to their HubSpot accounts before generating presentations in Matik, click the checkbox.

hubspot_hc_article2.png

 

Matik uses oAuth to complete your connection. Click on “Connect to Data Source” and enter your HubSpot credentials when prompted. Select the HubSpot account you would like to use with Matik and click “Choose Account.”

 

hubspot_hc_article.png

 

Give the Matik app permission to connect to HubSpot by clicking on “Connect app” on the next screen. The popup window will close, and your HubSpot data source will be connected.

 

hubspot_hc_article3.png

 

hubspot_hc_article4.png

 

HubSpot Requirements and Gotchas

The standard HubSpot object “Companies” must be enabled in your instance of HubSpot for the integration to work.

You may run into a connection issue if you delete your HubSpot data source in the Matik app and try to add it as a data source in Matik again.

 

hubspot_hc_article5.png

This can be resolved by going to HubSpot settings > Account Setup > Integrations > Connected Apps, then uninstalling the Matik App. After completing this, you should be able to add HubSpot back into Matik using the instructions above.

 

hubspot_hc_article6.png

See the Using HubSpot as a Dynamic Content Datasource help article for more information about using HubSpot with Matik.

Was this article helpful?

Have more questions? Submit a request

Related articles

  • Using Salesforce (SFDC) in Dynamic Content
  • Connecting to Data Warehouses
  • Matik App for Salesforce Setup
  • Using SSO's to sign in to Matik (Okta, Onelogin, Azure, Google)
  • Dynamic Content Overview

Articles in this section

  • Data Sources Overview
  • Data Source Permissions
  • Connecting to CRMs (Salesforce, Hubspot, Gainsight)
  • Connecting to Data Warehouses
  • Connecting to Excel as a Data Source
  • Connecting to Google Sheets
  • Connecting to Rest APIs
  • Connecting to BI Tools (Tableau, Looker, Microsoft Power BI)
  • Connecting to a Data Source using an SSH tunnel

Comments

0 comments

Please sign in to leave a comment.

Personalize data-driven content in minutes

Product

  • How it Works
  • Integrations
  • AI Features
  • Security

Solutions

  • Sales
  • Customer Success
  • Ops & Strategy
  • Data

Resources

  • Blog
  • Templates
  • AI + CS Resource Hub
  • Case Studies
  • Help Center

Company

  • About Us
  • Careers
  • Terms of Service
  • Privacy Policy

© 2024 Matik, Inc.