Skip to main content
Markifact supports two ways to connect BigQuery: using the built-in Markifact app (Quick Connect) or connecting through your own Google Cloud app (Custom App). With a custom app, every request Markifact makes runs under your app in the project’s audit logs, so your clients never see Markifact.
Custom app connections are available on the Team plan. See White-label Connections for the overview.

​
What You Need

Query costs are billed to the project you query, exactly as with Quick Connect. The Cloud project that owns your OAuth client can be a different project from the ones holding your data.

Create the app and mint the refresh token

The Google Cloud setup (project, consent screen, OAuth client, OAuth Playground) is the same for every Google channel and lives on one page.

​
Connect to Markifact

1

Open the Custom App tab

Go to the Connections page, click Connect on BigQuery, and select the Custom App (White-label) tab.
2

Name the connection

Enter a Connection Name (for example “Acme Agency BigQuery”). This is how the connection appears in nodes, agents, and MCP.
3

Paste your credentials

Paste the Client ID, Client Secret, and Refresh Token from your Google Cloud app.
4

Verify & Connect

Markifact refreshes an access token with your client and makes one read-only call to the BigQuery API. Nothing is saved unless both succeed.
Custom app connections show a Custom app badge on the Connections page and work everywhere a Quick Connect connection works.

​
Rotating or Replacing the Token

Add the connection again with the same connection name and the new refresh token. Markifact replaces the stored credentials in place, so workflows and agents bound to the connection keep working.

​
Troubleshooting

The Google account behind the token has no BigQuery access on any project. Grant it BigQuery roles in IAM, then re-add the connection with the same name.
See the shared Custom Google Cloud App troubleshooting for invalid_client, invalid_grant, missing scopes and APIs that are not enabled.

Custom Google Cloud App

Create the app and mint a refresh token

Run Query

Query BigQuery tables