# Integrate Freshdesk with Databox Freshdesk is cloud-based customer support software that centralizes inquiries across email, phone, chat, and social media. It offers features like ticket management, automation, and analytics to streamline workflows, improve team collaboration, and enhance customer satisfaction. ## Connection ### Before you begin ### Add a connection To connect Freshdesk to your Databox account for the [first time](/add-a-connection) or with new credentials: 1. **Enter your Freshdesk domain** — This is the unique part of your Freshdesk URL. Use only the domain name without `http://` or `https://`. 1. E.g. `databox.freshdesk.com` 2. **Get your Freshdesk API key** — In Freshdesk, click your profile picture in the top right corner, go to **Profile Settings**, then click **View API Key** to copy it. 1. You can [follow these detailed instructions from Freshdesk](https://support.freshdesk.com/support/solutions/article/215517-how-to-find-your-api-key) if needed. connect ## Metric Builder The Freshdesk integration allows you to create custom metrics using the metric builder, ideal for visualizing data not included in the basic metrics offered by the integration. metric-builder To create a custom metric, start by selecting a metric from the "Metric" selector. Next, customize your metric by optionally adding a dimension and applying one or more filters. The available options depend on the selected entity and data type (e.g., number, text, etc.). The entities accessible for metric creation are listed below. ### Tickets In Freshdesk, tickets are digital records of customer inquiries, issues, or requests that need resolution by the support team. When a customer contacts a company through email, chat, phone, social media, or a support portal, Freshdesk automatically converts that interaction into a ticket. **In Freshdesk:** Click Tickets in the sidebar. ### Companies In Freshdesk, a Company represents an organization associated with one or more contacts, allowing businesses to manage and track support requests from customers belonging to the same company. This is particularly useful in B2B scenarios where multiple individuals from a single organization may raise support tickets. **In Freshdesk:** Click Companies in the sidebar. ### Contacts In Freshdesk, a Contact represents an individual customer or end-user who interacts with the support team, usually by submitting support tickets. Each contact holds key personal and communication details such as name, email address, and phone number, which help agents identify and assist the customer efficiently. Contacts can also include additional attributes. They may be linked to a company, allowing for better organization in B2B scenarios. **In Freshdesk:** Click Contacts in the sidebar. ## ![lock](/assets/lock.2fb1bbc208afcc03d15a0a45f22bdf7f830322016e038e5721965851130807af.419bb737.svg) Datasets The Freshdesk integration supports the creation of [datasets](/understanding-datasets), which allow you to structure and format your Freshdesk data for more flexible reporting in Databox. By organizing your data into a tabular format, datasets make it easier to filter, segment, and visualize key metrics across projects, clients, and team members. The entity relationship diagram (ERD) below illustrates how data is organized within the Freshdesk integration, displaying the available **views** and **columns**, as well as the relationships between them (primary and foreign keys). This diagram represents the **schema**, or structure, of the data and helps you understand the underlying data model. With this context, you can create datasets using the relevant views and columns to build custom metrics tailored to your reporting needs. ## Resources For comprehensive details on metrics, data availability, templates, specifications, usage guidelines, and other key information, refer to the resources listed below. Only Freshdesk plans with API access can be connected to Databox. Refer to [this Freshdesk guide](https://support.freshdesk.com/support/solutions/article/215517-how-to-find-your-api-key) to learn whether API access is available on your plan. The metric builder pulls raw and analytics data from Freshdesk's APIs. If an entity or property is missing, it is likely due to limited API support or technical implementation restrictions. If there's something you'd like to see included, feel free to [submit a request](https://roadmap.databox.com/b/metric-requests/) on our Roadmap, so we can consider it for future updates to the integration.   Ask Genie Get instant answers or help with your data using the in-app AI assistant. Talk to an expert For customers: Get help with your setup, strategy, or making the most of Databox. Book a demo New to Databox? See how it works and get guidance on getting started. Send an email Reach out to support for help with your account, data, or technical issues.