How to register your own Looker OAuth app

This guide shows you how to register an OAuth client application with your Looker instance. This is required before any user can authenticate into the Looker API via OAuth.

Install the API Explorer

The API Explorer is a Looker Marketplace extension used to register OAuth apps.

Log in to your Looker instance with admin access. You need the develop, manage_models, and deploy permissions to install from the Marketplace.
Navigate to the Looker Marketplace and search for API Explorer.
Install the extension. Once installed, it appears under Applications in the left sidebar.

If your admin has enabled Auto Install in Admin > Platform > Marketplace, the API Explorer is already installed and kept up to date automatically.

Add your origin to the embedded domain allowlist

Looker requires your application's origin to be allowlisted before OAuth code exchange can succeed.

Navigate to Admin > Embed.
Under Embedded Domain Allowlist, add https://api.tenklo.dev.

Do not include a trailing slash (/) in the domain URL.

Open the API Explorer from the Applications section of the left sidebar.

Admins can also open it via Admin > API > Use API Explorer.
Using the version drop-down at the top, select 4.0 - current.
Search for register_oauth_client_app in the Search field, or navigate to the Auth method category and find it there.
Select the method and click Run It to open the request panel.
In the Request tab, fill in the following parameters:

Parameter	Value
`client_guid`	A unique identifier for your app (e.g., `my-nango-app`)
`redirect_uri`	`https://api.tenklo.dev/oauth/callback`
`display_name`	The name shown to users on the consent screen
`description`	What your app does with the user's Looker account

Check the data change confirmation checkbox (required for POST requests).
Click Run to register the application. The Response tab will confirm the registration.

Follow the Quickstart to connect your first account.

For more details, see Looker's OAuth authentication documentation.