---
title: "Centra connection guide"
slug: "centra-connection-guide"
description: "Connect your Centra data to Supermetrics with our guide on API tokens, Endpoint URLs, and query types for seamless data integration."
updated: 2026-07-08T09:01:35Z
published: 2026-07-08T09:01:35Z
canonical: "docs.supermetrics.com/centra-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.

# Centra connection guide

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

## Required permissions

You need an **API token** and an **Endpoint URL** to connect to Centra.

### How to create an API token

1. Log in ot your Centra Dashboard.
2. In the navigation on the left, go to **System → API tokens**.
3. In the top right corner, click **Create integration API token**.
4. Enter the required details such as an expiration date and description so that you can easily identify the API token later, for example “Supermetrics”.
5. In the **Stores** list, select at least one store that you want to fetch data for.
6. Under permissions, select the following **Read permissions**:
  1. Order details
  2. Order.shippingAddress
  3. Return details
  4. Shipment details
  5. Product details
  6. Market details
  7. PaymentHistory
  8. Store details
  9. Currency details
7. Click **Save**.

### How to find your Endpoint URL

1. Log in to your Centra Dashboard.
2. In the navigation on the left, go to **System → API tokens**.
3. The Endpoint URL is visible at the top of the page. It should follow the format “https://shop-name.centra.com/graphql”.

## Query types

Query types define what sort of metrics and dimensions are available. You need to select one of the following query types when pulling data:

- **Order items**
- **Return items**

## Connection instructions

When connecting to Centra, you need to log in to Centra and enter your Endpoint URL and API token.

1. Select the Centra data source [on the Supermetrics Hub](https://hub.supermetrics.com/token-management) or in the data destination.
2. Insert the Endpoint URL, API token and give a name for your log in.
3. If prompted, choose to make this connection [shared or private](https://docs.supermetrics.com/docs/about-shared-and-private-connections).
4. Click **Start**.
5. In your data destination, select the store(s) for which you want to fetch data and the query type you want 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 Centra 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)