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. On the Hub, you can also share an 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.
Required permissions
You need an API Token and an Endpoint URL in order to connect to Centra.
How to create an API token
- Log in to your Centra Dashboard.
- In the navigation on the left, go to System → API tokens.
- In the top right corner, click Create integration API token.
- Enter the required details such as an expiration date and description so that you can easily identify the API token later, for example "Supermetrics".
- In the Stores list, select at least one store that you want to fetch data for.
- Under permissions, select the follow Read permissions:
- Order details
- Order.shippingAddress
- Return details
- Shipment details
- Product details
- Market details
- PaymentHistory
- Click Save.
How to find your Endpoint URL
- Log in to your Centra Dashboard.
- In the navigation on the left, go to System → API tokens.
- 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.
- Select the Centra data source on the Supermetrics Hub or in the data destination.
- Insert the Endpoint URL, API token and give a name for your log in.
- If prompted, choose to make this connection shared or private.
- Click Start.
- In your data destination, select the store(s) to fetch data for and query type to use.
See detailed instructions on how to connect to a data source from the Supermetrics Hub.
You can also connect to Centra from these destinations:
- Google Sheets: How to log in to a Supermetrics data source in Google Sheets
- Looker Studio: How to connect data sources to Looker Studio
- Excel: How to connect data sources to Excel with Supermetrics
- Power BI: How to create your first Supermetrics query for Power BI
- The Supermetrics API: How to use the Query Manager
- Data warehouse and cloud storage (Hub): How to create a transfer
- BigQuery (marketplace): How to create a BigQuery (marketplace) transfer