---
title: "Salesforce connection guide"
slug: "salesforce-connection-guide"
description: "Connect your Salesforce data to Supermetrics with our guide on permissions, requirements, and step-by-step instructions for seamless integration."
updated: 2026-07-08T11:55:44Z
published: 2026-07-08T11:55:44Z
canonical: "docs.supermetrics.com/salesforce-connection-guide"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.supermetrics.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Salesforce connection guide

This guide contains all permissions and requirements for connecting your Salesforce data to Supermetrics.

You can connect to data sources from the [Data sources page on the Supermetrics Hub](https://hub.supermetrics.com/token-management). On the Hub, you can also [share an authentication link](https://docs.supermetrics.com/v1/docs/how-to-connect-to-data-sources-from-supermetrics-hub#share-authentication-link) to connect to a data source you don't have direct access to.

After you connect to the data source on the Hub, you can use the data source connection in [all available destinations](/docs/salesforce-connection-guide#connection-instructions).

> [!NOTE]
> Note
> 
> It's important to contact your Salesforce system administrator for help before you begin this process. Salesforce instances often have custom security settings that need careful attention.

## Required permissions

To connect Supermetrics to Salesforce, you need read access to objects and fields. [Learn more about Salesforce permissions](/v1/docs/salesforce-permissions-troubleshooting-guide).

Supermetrics supports the following objects and the fields under them: accounts, campaigns, contacts, leads, opportunities, orders, tasks, and their custom fields.

## Connection instructions

When connecting to Salesforce, you need to log in to Salesforce and select the accounts to use.

> [!NOTE]
> Note
> 
> If this is the first time Salesforce is being used with Supermetrics, these steps must be performed first by an organization Administrator or user with “Download AppExchange Packages” permissions.

1. Select the Salesforce data source [on the Supermetrics Hub](https://hub.supermetrics.com/token-management) or in the data destination.
2. If prompted, choose to make this connection [shared or private](https://docs.supermetrics.com/docs/about-shared-and-private-connections).
3. Click **Start**.
4. Enter your Salesforce email address and password, and click **Log in**. The package for the Supermetrics app will now attempt to install.
  - If you’re not an administrator, you’ll be blocked from installing. **Please work with your organization administrator to install Supermetrics before proceeding**.
  - If you’re an administrator:
    1. Select which users the app will be installed for. Make sure to select an option that will allow the person who will use Supermetrics to use the app, for example, install for all members or install for specific users.
    2. Check the box acknowledging that you’re installing an unapproved app. Note that this warning will go away once Supermetrics completes the partner security review in summer 2026.
    3. Click **Install**.
    4. Once the installation is complete (it may take a moment if you have a lot of organization members), you can click **Done,** and flow will take you to the Salesforce app manager for your organization.
5. Go back to the Supermetrics Hub or to the data destination and select the Salesforce data source.
6. If prompted, choose to make this connection [shared or private](https://docs.supermetrics.com/docs/about-shared-and-private-connections).
7. Click **Start**.
8. Enter your Salesforce email address and password, if needed, and click **Log in**.
9. Click **Allow** to allow access.
10. In your data destination, select the accounts you'd like to include in your reporting.

See detailed instructions on [how to connect to a data source from the Supermetrics Hub](https://docs.supermetrics.com/docs/how-to-connect-to-data-sources-from-supermetrics-hub).

You can also connect to Salesforce from these destinations:

- Google Sheets: [How to connect to a Supermetrics data source in Google Sheets](https://docs.supermetrics.com/docs/how-to-connect-to-a-supermetrics-data-source-in-google-sheets)
- Data Studio: [How to connect data sources to Data Studio](/v1/docs/how-to-connect-data-sources-to-data-studio)
- Excel: [How to connect data sources to Excel with Supermetrics](https://docs.supermetrics.com/docs/how-to-connect-data-sources-to-excel-with-supermetrics)
- Power BI: [How to create your first Supermetrics query for Power BI](https://docs.supermetrics.com/docs/how-to-create-your-first-supermetrics-query-for-power-bi)
- The Supermetrics API: [How to use the Query Manager](https://docs.supermetrics.com/docs/how-to-use-the-query-manager)
- Data warehouse and cloud storage (Hub): [How to create a transfer](https://docs.supermetrics.com/docs/how-to-create-a-transfer)
- BigQuery (marketplace): [How to create a BigQuery (marketplace) transfer](https://docs.supermetrics.com/v1/docs/how-to-create-a-bigquery-marketplace-transfer)

## More resources

- [Salesforce report building guide](/v1/docs/salesforce-report-building-guide)
- [Salesforce permissions troubleshooting guide](/v1/docs/salesforce-permissions-troubleshooting-guide)
- [How to reauthenticate a data source connection](/v1/docs/how-to-reauthenticate-a-data-source-connection)
- [How to manage data source connections on the Supermetrics Hub](https://docs.supermetrics.com/docs/how-to-manage-data-source-connections-on-supermetrics-hub)