--- title: "CallRail connection guide" slug: "callrail-connection-guide" description: "Connect your CallRail data to Supermetrics with our guide. Learn about permissions, API keys, and query types for effective data reporting." updated: 2026-05-06T11:41:45Z published: 2026-05-06T13:26:01Z --- > ## 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. # CallRail connection guide This guide contains all permissions and requirements for connecting your CallRail 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](/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](/v1/docs/callrail-connection-guide#connection-instructions). ## Required permissions To connect Supermetrics to CallRail, you need: - An API key. [Follow CallRail’s instructions to create your key](https://support.callrail.com/hc/en-us/articles/5711821845389-CallRail-s-API-documentation). - The Admin, Manager, or Reporting user role level for each business account. Learn more about [user roles in CallRail](https://support.callrail.com/hc/en-us/articles/5711810545421-Users) and [user management](https://support.callrail.com/hc/en-us/articles/5712155833613-Editing-and-removing-users-in-Account-Center). > [!NOTE] > Note > > CallRail's API usage is based on tiers. 0-1500 API calls per month are free but heavier usage may incur additional charges from CallRail. More information on CallRail's API tiers is available [here](https://support.callrail.com/hc/en-us/articles/5711821845389-CallRail-s-API). ## 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: - **Calls** - Returns data on calls and leads acquired through calls. Find metrics like the number of calls, answer rate, call duration, lead amount, and lead value. - Gathers data about call insights by splitting the data by time, call source, number, or agent. This can help with resource planning and identifying the best-performing agents. - Gathers data on a specific call and fetches direct links to recordings. - **Form submissions** - Returns data on form submissions and leads acquired through forms. Find metrics like the number of form submissions, lead amount, and lead value. - Gathers lead insights by splitting the data by time or by source. You can also fetch all form submission data to dig into specific answers. ## Connection instructions When connecting to CallRail, you need to provide your API key and select the accounts to use when prompted. 1. Select the CallRail data source [on the Supermetrics Hub](https://hub.supermetrics.com/token-management) or in the data destination. 2. Enter your API key. 3. If prompted, choose to make this connection [shared or private](/v1/docs/about-shared-and-private-connections). 4. Click **Start**. 5. In your data destination, select the accounts you'd like to include in your reporting and a query type to use. See detailed instructions on [how to connect to a data source from the Supermetrics Hub.](/v1/docs/how-to-connect-to-data-sources-from-supermetrics-hub) You can also connect to CallRail from these destinations: - Google Sheets: [How to log in to a Supermetrics data source in Google Sheets](/v1/docs/how-to-connect-to-a-supermetrics-data-source-in-google-sheets) - Data Studio: [How to connect data sources to Looker Studio](/v1/docs/how-to-connect-data-sources-to-looker-studio-formerly-data-studio) - Excel: [How to connect data sources to Excel with Supermetrics](/v1/docs/how-to-connect-data-sources-to-excel-with-supermetrics) - Power BI: [How to create your first Supermetrics query for Power BI](/v1/docs/how-to-create-your-first-supermetrics-query-for-power-bi) - The Supermetrics API: [How to use the Query Manager](/v1/docs/how-to-use-the-query-manager) - Data warehouse and cloud storage (Hub): [How to create a transfer](/v1/docs/how-to-create-a-transfer) - BigQuery (marketplace): [How to create a BigQuery (marketplace) transfer](/v1/docs/how-to-create-a-bigquery-marketplace-transfer) ## More resources - [CallRail report building guide](/v1/docs/callrail-report-building-guide) - [How to reauthenticate a data source in Google Sheets, Looker Studio, Excel, or Power BI](/v1/docs/how-to-reauthenticate-a-data-source-connection-in-google-sheets-looker-studio-excel-power-bi-and-supermetrics-hub) - [How to reauthenticate a data source in data warehouse, API, or cloud storage platform](/v1/docs/how-to-reauthenticate-a-data-source-connection-in-data-warehouse-destinations-or-the-supermetrics-api) - [How to manage data source connections on the Supermetrics Hub](/v1/docs/how-to-manage-data-source-connections-on-supermetrics-hub)