# Guide: Using Help Scout Mailbox with Databox

## How to connect Help Scout Mailbox to Databox

![](/assets/guide-using-help-scout-mailbox-with-databox_1.ca1f9f1087233c88422f3b63401c57c2481f089c933e7a9d2db7fd2bbc1459ee.4783b0ec.gif)

To connect a Help Scout Mailbox in Databox, go to  **Data Manager > + New connection.** Type **Help Scout Mailbox** in the search bar and click on the green **Connect**button. Next, click the green **Connect now** button.

This will open the  **Authorization** window. Click on the blue **Authorize** button to authorize the Databox app.

Each Help Scout Mailbox must be connected as a separate Data Source in Databox (1 Account = 1 Data Source). Learn more [here](/add-a-connection)

## Which Help Scout Mailbox Plans have API access

You should be on the Pro or Plus Help Scout plan in your Help Scout Account to access reporting endpoints via API integration. An Access Denied Error can occur if you are on a standard plan in your Help Scout Account.

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

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

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](/data-sync-storage-security-in-databox).
The amount of historical data you're able to access in Databox is dependent on your Databox plan. Learn more [here](/choose-a-subscription-plan).

What time zone does Help Scout Mailbox data sync in?

Help Scout Mailbox data is synced in UTC.

## How to access pre-built Help Scout Mailbox Templates

![](/assets/guide-using-help-scout-mailbox-with-databox_2.55eddd3f16bc8ebe35065d9db2b77c3da787b01ffe9ffe01d6003a908aa76b24.4783b0ec.gif)

1. Navigate to  **Databoards > Public Templates**.
2. In the **Data Source** drop-down list, select **Help Scout Mailbox**.
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 Help Scout Mailbox data, click **Use Template**.
5. Select the appropriate Help Scout Mailbox Data Source from the drop-down list to complete the process. The Databoard will be re-populated with data from the selected Help Scout Mailbox and can be found on the **Databoards** page.


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](/overview-designer).

View a full list of Help Scout Mailbox Metrics available in Databox [here.](https://app.databox.com/metrics/library/Helpscout)

## How to build a Databoard

![](/assets/guide-using-help-scout-mailbox-with-databox_3.3de65de2f95035c5e3e6ec401541d724fc3aa4f045e86930ccdf2beb746d374f.4783b0ec.gif)

1. Navigate to  **Databoards** > **+ New Databoard** > **Start Blank**.
2. Click on the **Metric Library** icon on the left-hand side of the Designer.
3. Select the appropriate Help Scout Mailbox from the **Data Source** drop-down list in the **Metric Library**.
4. View the list of pre-built Help Scout Mailbox 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 Editor**on the right-hand side of the Designer.
8. In the **Metrics** drop-down, click  **Data Source** to select the appropriate Data Source. This will filter out metrics from the specific Data Source.
9. In the main **Metrics** drop-down, select the metric you'd like to display on the Datablock, using the Search bar if needed. This will update the Datablock, and it will populate with the corresponding data.
10. Complete steps 4-9 until your Databoard is complete


## Metric Considerations

- Due to API limitations, the Metric “Conversations by Tag” will only return data for the most frequently used tags.
  - If the tag was just created and added to specific conversations in the Help Scout Mailbox, it may take some time to update it in the API and appear in the response. If the tag is not used, it won't return any data. Learn more [here](https://developer.helpscout.com/mailbox-api/endpoints/reports/conversations/reports-conversations-overall/).