Skip to main content
Markifact supports two ways to connect Google Search Console: 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 property’s users and permissions, 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

Request the full webmasters scope, not webmasters.readonly: URL inspection and sitemap submission need write access.

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 Google Search Console, and select the Custom App (White-label) tab.
2

Name the connection

Enter a Connection Name (for example “Acme Agency Search Console”). 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 Google Search Console 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 is not a user on any Search Console property. Add it under Settings > Users and permissions in Search Console, 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

Get Report

Pull Search Console performance data