---
title: "Smarp connection guide"
slug: "smarp-connection-guide"
description: "Connect your Smarp data to Supermetrics with our guide. Learn about permissions, API keys, and query types for seamless data integration."
updated: 2026-07-08T11:55:44Z
published: 2026-07-08T11:55:44Z
canonical: "docs.supermetrics.com/smarp-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.

# Smarp connection guide

This guide contains all permissions and requirements for connecting your Smarp 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/smarp-connection-guide#connection-instructions).

## Required permissions

To connect Supermetrics to Smarp, you need:

- **A Smarp subdomain**. This is the subdomain from your URL.
  - This is found after the `https://` in your Smarp URL. For example, in the URL `https: //examplestore.smarpshare.com`, **examplestore** is the Smarp subdomain.
- **An API key**. You'll find this in the Smarp dashboard — remember to keep it safe once you have it. Read the [Authentication section of Smarp's basic concepts documentation](https://smarp.github.io/v1/#section/Basic-concepts/Versioning) to learn more.
- **An account name.** This is the name you choose for your login. We recommend using your account's name.

## Query types

Query types define what sort of metrics and dimensions are available. To access most query types, you'll need the **Company Admin** role level. You need to select one of the following query types when pulling data:

- **Clicks:** Returns all clicks based on the period in which clicks happened.
- **Campaigns:** Returns campaigns for a specific company.
- **Groups:** Returns all groups within the instance.
- **Posts:** Returns posts based on the period in which posts were published. Posts that have been deleted or were published in private channels won't be returned.
- **Shares:** Returns all shares based on the period in which the share was done.
- **Teams:** Returns all teams in the instance.
- **Users**: Returns users in the company.

## Connection instructions

When connecting to Smarp, you need to give your Smarp subdomain and an API key.

1. Select the Smarp data source [on the Supermetrics Hub](https://hub.supermetrics.com/token-management) or in the data destination.
2. Enter your Smarp subdomain and API key.
3. Give your login a name to recognize the login later if you have multiple logins.
4. If prompted, choose to make this connection [shared or private](https://docs.supermetrics.com/docs/about-shared-and-private-connections).
5. Click **Start**.
6. In your data destination, select the query type to use.

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 Smarp 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

- [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)