Setup Connector

More about what is a connector, you can read here: Data connector.

Kaivo connects to hundreds of data sources through a consistent setup flow: find the connector, name your connection, authenticate, select the data you want to sync, and set a schedule. The details vary by source but the overall pattern is the same across all connectors.

This article walks through setting up Google Search Console as a worked example. If you are connecting a different source, the steps will follow the same structure, with connector-specific fields appearing after authentication.
Note: the authentication method varies. Some use OAuth like Google connectors but others use API keys or other information. Kaivo will walk you through the necessary steps and tell you what you need to do.

Step 1 — Add a new connector

From your Kaivo dashboard, navigate to the Data connectors tab and click New connector.

In the connector catalog, search for or scroll to Google Search Console and click on it.

Enter a recognizable name in the Connector Name field (pre-filled as Google Search Console by default) and click Save.

Under How do you want to connect?, leave the selection as Your account and click Sign in with Google.

A Google OAuth window will appear. Select the account that has access to your Search Console property and click Continue to grant Kaivo the necessary permissions.

Step 2 — Connect the data source

Once authenticated, set two required fields:

• Website URL Property — enter the exact property URL as it appears in Google Search Console (e.g., kaivo.io)

• Start Date — the earliest date from which Kaivo will fetch data (e.g., 01.01.2025). Data before this date will not be retrieved.

Click Connect to proceed.

Step 3 — Select data to sync

Choose which datasets to bring into your data warehouse. Confirm your selection to start the initial sync.

Step 4 — Schedule automatic updates

Select a daily sync time and matching time zone (e.g., 03:15 Europe/Helsinki) and click Set schedule.

If you want to run syncs manually for now, click Schedule later.

Step 5 — Monitor your sync

On the connection overview page, the status will show Data sync running. The Data sync history log tracks progress in real time.

Once complete, the status updates to Latest data sync succeeded. Depending on data volume, this may take a few minutes or up to a couple of hours.