1. Help Center
  2. Data Source Guides

Guide: Using Freshdesk with Databox


How to connect Freshdesk to Databox


How to connect Freshdesk to Databox

To connect a Freshdesk Account in Databox, go to  Data Manager > + New connection. Type Freshdesk in the search bar and click on the green Connect button. 

This opens the  Authorization window, which is where you will be prompted to enter your Freshdesk Domain and API Key

Enter the unique part of your Freshdesk domain in the Domain field. This must exactly match the domain from your Freshdesk URL. 

Pro Tip: Users with a free Freshdesk account will have the following URL structure: '' domain.freshdesk.com'' (e.g. yourcompany.freshdesk.com). Users with a paid Freshdesk account will have the following URL structure: '' support. domain.com'' (e.g. support.yourcomapny.com). Learn more about Freshdesk domains here.

Next, to find your API Key in Freshdesk, follow the steps below:

  1. Login to your Freshdesk Account
  2. Navigate to the  Profile icon and select Profile Settings
  3. In the right top corner, copy the API Key from Your API Key field

Once you enter Domain and API Key in Databox, click Activate.

What's the maximum amount of historical data initially available when you use a new Freshdesk Data Source Metric in Databox?

Data is synced for the Metrics that are being used in your Account, so when you first use a new Freshdesk Metric, the maximum amount of historical data available is 36 months. 

Certain Metrics may have more or less historical data available. For example, metrics that represent the total metric value (i.e. Open Tickets, Companies, etc.) do not have historical data available when first used. We only pull in the total current value, but we will accumulate historical data for these Metrics in Databox over time and the metric value will be shown cumulatively.  

For more information about the amount of historical data available for a specific Metric, please contact our Support Team at help@databox.com.

Pro Tip: In order to start syncing data for a Metric, you can add it to your Metrics screen, use it in a Scorecard, set a Goal around it, create an Alert for it, or add it to a Databoard. Learn more here.  

The amount of historical data you're able to access in Databox is dependent on your Databox plan. Learn more here.

What time zone does Freshdesk data sync in? 

Freshdesk data is synced in UTC. 

How to access pre-built Freshdesk Templates

  1. Navigate to Databoards > Public Templates
  2. In the Data Source drop-down list, select Freshdesk
  3. To view a preview of the Template populated with dummy data, click Preview
  4. To pull the Template into your Account and re-populate it with your own Freshdesk data, click Use Template
  5. Select the appropriate Freshdesk Data Source from the drop-down list to complete the process. The Databoard will be re-populated with data from the selected Freshdesk Account and can be found on the  Databoards page

Pro Tip: Once the Databoard is available on the Databoards page, it is completely disconnected from the public Template. Therefore, you can further customize this Databoard to meet your specific needs using the Designer.

Popular Freshdesk Templates

Freshdesk Tickets Overview
This template provides you an overview of ticket stats, such as created tickets, resolved tickets, hours tracked, billable hours, and more.  

How to build a Databoard using Freshdesk data


Popular Freshdesk Metrics

Freshdesk Created Tickets

Freshdesk Resolved Tickets

Freshdesk Hours Tracked

View a full list of Freshdesk Metrics available in Databox here.

How to build a Databoard

  1. Navigate to  Databoards > + New Databoard > Start Blank
  2. Click on the Metric Library icon on the lefthand side of the Designer.
  3. Select the appropriate Freshdesk Account from the Data Source drop-down list in the Metric Library.
  4. View the list of pre-built Freshdesk Datablocks in the  Metric Library. Drag and drop your selected Datablock onto your Databoard.
  5. If a pre-built Datablock isn't available for your use case, click on the  Visualization Types icon under the Metric Library icon.
  6. View the list of Visualizations available in Databox. Drag and drop your selected Visualization onto your Databoard.
  7. Click on the Datablock on the Databoard to open the corresponding Datablock Settings on the righthand side of the Designer.
  8. Select the appropriate Freshdesk Data Source and Metric in the righthand Datablock Settings. This will update the Datablock, and it will populate the Datablock with the corresponding data.
  9. Complete steps 4-8 until your Databoard is complete

How to use the Metric Builder for Freshdesk

With the Metric Builder for Freshdesk, you can create Custom Freshdesk Metrics using a combination of Metrics, Dimensions, and Filters. Some popular use cases for the Metric Builder for Freshdesk include tracking Open Tickets, Hours Tracked by Ticket, and further filtering data by Custom Fields from Freshdesk account. 

Learn more about the Metric Builder for Freshdesk here