# Looker

{% content-ref url="looker-integration/looker-metadata" %}
[looker-metadata](https://docs.secoda.co/integrations/data-visualization-tools/looker-integration/looker-metadata)
{% endcontent-ref %}

There are three steps to connect Looker with Secoda:

1. Retrieve your Looker Client ID and Client Secret
2. Retrieve your Looker host
3. Connect Looker to Secoda
4. Looker Lineage (Optional)

#### **Retrieve you Looker Client ID and Client Secret** <a href="#h_fe76e01a02" id="h_fe76e01a02"></a>

Create API3 credentials on the [Users page](https://docs.looker.com/admin-options/settings/users) in the Admin section of your Looker instance. If you’re not a Looker admin, ask your Looker admin to create the API3 credentials for you.

To create an API3 credential, click **Edit** on a user and then under **API3 Keys** click **Edit Keys**.

![](https://downloads.intercomcdn.com/i/o/378332385/8e16211840f3aa4d3a3aade6/Screen+Shot+2021-08-19+at+10.45.42+PM.png)

Create a key, and then save the **Client ID** and **Client Secret**

#### **Retrieve your host** <a href="#h_75eb18a905" id="h_75eb18a905"></a>

Your **host** is the url of your Looker instance, for example `https://company.cloud.looker.com`

Sometimes an admin will have specified a custom API url. If that's the case, reach out to your admin and ask them to provide that url.

#### **Connect Looker to Secoda** <a href="#h_f136e3163c" id="h_f136e3163c"></a>

After retrieving your Looker Client ID, Client Secret, and host , the next step is to connect to Secoda:

1. In the Secoda App, select **Add Integration** on the Integrations tab
2. Search for and select Looker
3. Enter your Looker Client ID, Client Secret, and host you retrieved above
4. Click 'Connect'

#### Connect Looker Lineage (Optional) <a href="#h_306dadb3b4" id="h_306dadb3b4"></a>

To get lineage between Looker and your data warehouse, Secoda will need access your GitHub repo where Looker records changes and manages file versions. Secoda will then automatically detect LookML projects connected to your Looker instance.

Navigate to the `Project` tab on the Looker Integration Page and you will see your LookML projects. For each project you want to connect, click the toggle beside the project name.

Once the key is generate, you can select your LookML project and click **Copy public key** and head to your LookML repo in GitHub.

<figure><img src="https://secoda-public-media-assets.s3.amazonaws.com/c094befb-07ec-4528-8734-914d4366bcb3.png" alt=""><figcaption></figcaption></figure>

#### GitHub

Once in your GitHub repo, click on **Settings > Deploy keys** on the sidebar.

A new key can be added by clicking on **Add deploy key** button in the top right corner.

<figure><img src="https://secoda-public-media-assets.s3.amazonaws.com/3a8f9c54-6990-4294-bfc2-39cc30f9c853.png" alt=""><figcaption></figcaption></figure>

Set a title for your new key and then paste the key copied from Secoda into the **Key** text field.

<figure><img src="https://secoda-public-media-assets.s3.amazonaws.com/84c58a1a-60ca-48e7-ad0e-2c8a12cb7694.png" alt=""><figcaption></figcaption></figure>

#### GitLab

Once in your GitLab repo, click on **Settings > Deploy keys** on the sidebar.

<figure><img src="https://secoda-public-media-assets.s3.amazonaws.com/2999382b-e864-4bc8-9316-7d0ad8f39cb7.png" alt=""><figcaption></figcaption></figure>

Set a title for your new key and then paste the key copied from Secoda into the **Key** text field.

Click **Add key**. You **DO NOT** need to provide write access

Once the key has been added to GitHub or GitLab go back to your Looker integration in the Secoda App and go to the **Sync History** tab and click on **Run Sync** in the top right corner to start the sync process.

Note: You **DO NOT** need to start the sync process if you would rather wait until the next scheduled sync.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.secoda.co/integrations/data-visualization-tools/looker-integration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
