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 to connect to Centra.
How to create an API token
Log in ot 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 following 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) 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.
You can also connect to Centra from these destinations:
Looker Studio: How to connect data sources to Looker Studio
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