Last update: 2025-12-17T09:59:55.000Z
Content:
---
title: "Connect Hex to Tinybird · Tinybird Docs"
theme-color: "#171612"
description: "This guide covers the steps to connect Hex to Tinybird using the ClickHouse data source, enabling collaborative analytics and data science workflows."
inkeep:version: "forward"
---




# Connect Hex to Tinybird [¶](https://www.tinybird.co/docs/forward/work-with-data/publish-data/guides/connect-hex#connect-hex-to-tinybird)

Copy as MD Hex can connect to Tinybird using the ClickHouse® data source, taking advantage of Tinybird's ClickHouse® HTTP protocol compatibility. This enables you to use Tinybird data in Hex's collaborative analytics platform for notebooks, dashboards, and data applications.

The ClickHouse® connection to Tinybird is read-only. You can use it to analyze and visualize data from your Tinybird data sources, but you cannot modify data through this connection.

## Prerequisites [¶](https://www.tinybird.co/docs/forward/work-with-data/publish-data/guides/connect-hex#prerequisites)

- A Tinybird workspace with data sources
- A Tinybird Auth Token with scopes `WORKSPACE:READ_ALL`   and optionally `ORG_DATASOURCES:READ`   . See[  how to create it](../clickhouse-interface#auth-token-requirements)  .

## Add Tinybird as a data source [¶](https://www.tinybird.co/docs/forward/work-with-data/publish-data/guides/connect-hex#add-tinybird-as-a-data-source)

1. **  Navigate to Data browser**   : In your Hex project, go to**  Data browser**   in the left sidebar
2. **  Add a new connection**   : In the**  Warehouse**   tab click**  Add data  connection**
3. **  Select ClickHouse®**   : Choose**  ClickHouse®**   from the list of available data connection
4. **  Configure the connection**   with these settings:

### Connection configuration [¶](https://www.tinybird.co/docs/forward/work-with-data/publish-data/guides/connect-hex#connection-configuration)

Name: Tinybird Production  # Choose a descriptive name
Host: clickhouse.tinybird.co
Port: 443 See the list of [ClickHouse hosts](../clickhouse-interface#clickhouse-interface-hosts) to find the correct one for your region.

### Authentication settings [¶](https://www.tinybird.co/docs/forward/work-with-data/publish-data/guides/connect-hex#authentication-settings)

Username: <WORKSPACE_NAME>  # not used for auth, helps you identify the connection
Password: <TOKEN>  # Your Tinybird Auth Token
Enables SSL for ClickHouse: yes
1. **  Save the connection**   : Click**  Create connection**   to save the data source



<-figure->
![Hex ClickHouse® connection configuration](/docs/_next/image?url=%2Fdocs%2Fimg%2Fhex-clickhouse-connection.png&w=3840&q=75)

<-figcaption->
Hex ClickHouse® connection configuration

</-figcaption->


</-figure->
## Test the connection [¶](https://www.tinybird.co/docs/forward/work-with-data/publish-data/guides/connect-hex#test-the-connection)

Once configured, test your connection by creating a simple query:

1. Add SQL query cell to your Notebook
2. Select your newly created data connection
3. Write a simple query to test the connection

If the connection is working, you should see the result.

## Learn more [¶](https://www.tinybird.co/docs/forward/work-with-data/publish-data/guides/connect-hex#learn-more)

- [  ClickHouse Interface overview](../clickhouse-interface)
- [  Tinybird Auth Token management](/docs/classic/administration/auth-tokens)


