> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hightouch.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Looker

> Looker is a business intelligence software and big data analytics platform that helps you explore, analyze and share real-time business analytics easily.

> [!TIP]
>
> If you want to use your existing Looks to define Hightouch models, check out the [Looker model support docs](https://docs.hightouch.com/extensions/looker-models.md).

## Overview

Hightouch lets you pull data from Looker and push it to downstream destinations. Most of the setup occurs in the Hightouch UI, but you need access to Looker for information like your host, port, database name, and credentials.

> [!NOTE]
>
> You may need to allowlist Hightouch's IP addresses to let our systems connect to your warehouse. Reference our [networking docs](https://docs.hightouch.com/security/networking#ip-addresses) to determine which IP addresses you need to allowlist.

## Connection configuration

To get started, go to the [**Sources** overview page](https://app.hightouch.com/sources?from=docs) and click the **Add source** button. Select **Looker** and enter the following fields into Hightouch:

* **URL** - Hightouch uses this URL to connect to your Looker instance. The format is often `https://<instance_name>.looker.com`. Refer to [Looker's documentation](https://docs.looker.com/reference/api-and-integration/api-getting-started#looker_api_path_and_port) if you have a non-standard Looker setup.
* **Client ID** - You can find this in your [Looker API 3 credentials](https://docs.looker.com/reference/api-and-integration/api-auth).
* **Client secret** - You can find this in your [Looker API 3 credentials](https://docs.looker.com/reference/api-and-integration/api-auth).
* **Connection Name**: This field specifies the database connection to retrieve data from. Database connections are defined and named on the [**Connections**](https://docs.looker.com/admin-options/database/connections) page in the **Database** section of Looker's **Admin** panel. For more information, visit [Looker's Connections documentation. ](https://docs.looker.com/reference/model-params/connection-for-model).

## Test your connection

When setting up Looker as a source for the first time, Hightouch checks that you have the correct permissions. Once the test passes, click **Continue** to finish setup.

## Create models

Once your source configuration has passed the necessary validation, your source setup is complete. Next, you can set up [models](https://docs.hightouch.com/getting-started/concepts.md#models) to define which data you want to pull from Looker.

The Looker source supports these modeling methods:

* writing a query in [the SQL editor](https://docs.hightouch.com/models/sql-editor.md)
* using the visual [table selector](https://docs.hightouch.com/models/table-selector.md)
* leveraging existing [dbt models](https://docs.hightouch.com/extensions/dbt-models.md)

## Tips and troubleshooting

If you run into an issue this page doesn't cover, [contact support](#pylon-chat).
