What Looker terms mean
What this integration does
Profound connects to your Looker instance using API credentials (client_id, client_secret, and instance URL). Once connected, Profound Agents can:
- Run a saved Look — execute an existing Look and return the result as JSON for downstream agent steps
- Run an inline query — query a specific model and Explore with custom fields, filters, sorts, and advanced options
The integration is read-only and org-level. Profound runs queries against Looker and returns the results; it does not create, update, or delete Looker content. One Looker connection is shared across your organization and can be selected in any agent that needs it.
Where you can use Looker in Profound
Both surfaces use the same org-level Looker connection and the same read-only query capabilities.
Prerequisites
Before connecting Looker to Profound, ensure:- You have access to a Google Cloud Looker instance (for example,
https://your-company.cloud.looker.com) - You can create or use a Looker user with API credentials
- That user has permission to access the saved Looks, models, Explores, and fields your agents will query
How to create Looker API credentials
How to create Looker API credentials
- In Looker, go to Admin → Users and select the user Profound should use for API access
- In the user’s API credentials section, create a new API key pair
- Copy the generated Client ID and Client Secret before leaving the page — Looker may not show the secret again
- Confirm the user can access the Looks, models, Explores, dimensions, and measures your agents will need
Connect Your Account
- In Profound, go to Account → Integrations → Looker.
- Click Connect account.
- Enter your connection details:
- Looker Base URL — your instance URL, for example
https://your-company.cloud.looker.com - Client ID — the Looker API
client_id - Client Secret — the Looker API
client_secret
- Looker Base URL — your instance URL, for example
- Click Save.
Troubleshooting
The connection fails to save
The connection fails to save
Confirm the base URL is the root Looker instance URL, such as
https://your-company.cloud.looker.com. Profound also accepts URLs that include /api or /api/4.0 and normalizes them to the root instance URL.No Looks appear in agent nodes
No Looks appear in agent nodes
Make sure the Looker API user has access to the folders and saved Looks you expect to use. If permissions were recently changed, retry after a short delay.
A query returns a Looker permission error
A query returns a Looker permission error
Check the Looker user’s role, model set, and field-level permissions. Profound can only run queries that the connected Looker user is allowed to run.