Skip to content
Book a demoStart free
Connectors

Vercel connector

Set up the Vercel connector in Kaivo: authentication, configuration, the 9 BigQuery tables it syncs, and answers to common questions.

Vercel connector pricing, tier and credits on kaivo.io

Kaivo is a fully managed data platform that syncs your Vercel data into a Google BigQuery warehouse and keeps it up to date automatically. There is no pipeline to build and no infrastructure to run, so you can spend your time analysing your data from Vercel instead of moving it.

Sync your Vercel deployment data into BigQuery with Kaivo to analyse deployments, projects, and activity across your team.

CategoryTech
AuthenticationAPI key
SetupSelf-service
  1. Sign up for Kaivo and create a workspace.
  2. Connect your Vercel account.
  3. Choose which tables to sync.
  4. Wait for the initial sync to finish.
  5. Query your data in BigQuery or your favourite AI or BI tool.

Authenticate with your Access Token.

Field Description
Access Token
Access token to authenticate with the Vercel API. Create and manage tokens in your Vercel account settings.

|

When you set up the connector, you provide:

Field Description
Start Date
Any data before this date will not be fetched.

|

Kaivo syncs 9 tables from Vercel into a dedicated dataset in your BigQuery warehouse. Click any table to see its columns and types.

aliases (14 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
alias STRING
created STRING
created_at FLOAT64
creator__email STRING
creator__uid STRING
creator__username STRING
deployment__id STRING
deployment__url STRING
deployment_id STRING
project_id STRING
uid STRING
updated_at FLOAT64
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
auth_tokens (10 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
type STRING
active_at FLOAT64
created_at FLOAT64
expires_at FLOAT64
id STRING
name STRING
origin STRING
team_id STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
type STRING
created_at FLOAT64
expires_at FLOAT64
origin STRING
team_id STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
deployment_events (13 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
type STRING
created FLOAT64
date FLOAT64
deployment_id STRING
id STRING
info__type STRING
info__entrypoint STRING
info__name STRING
level STRING
serial STRING
text STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
deployments (39 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
type STRING
alias_assigned FLOAT64
building_at FLOAT64
created FLOAT64
created_at FLOAT64
creator__email STRING
creator__github_login STRING
creator__uid STRING
creator__username STRING
inspector_url STRING
is_rollback_candidate BOOL
meta__action STRING
meta__branch_alias STRING
meta__github_commit_author_login STRING
meta__github_commit_author_name STRING
meta__github_commit_message STRING
meta__github_commit_org STRING
meta__github_commit_ref STRING
meta__github_commit_repo STRING
meta__github_commit_repo_id STRING
meta__github_commit_sha STRING
meta__github_deployment STRING
meta__github_org STRING
meta__github_repo STRING
meta__github_repo_id STRING
meta__github_repo_owner_type STRING
meta__github_repo_visibility STRING
meta__original_deployment_id STRING
name STRING
ready FLOAT64
ready_state STRING
ready_substate STRING
source STRING
state STRING
target STRING
uid STRING
url STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
environments (13 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
type STRING
comment STRING
created_at FLOAT64
created_by STRING
decrypted BOOL
id STRING
key STRING
last_edited_by_display_name STRING
updated_at FLOAT64
value STRING
vsm_value STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
value STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
projects (77 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
account_id STRING
auto_assign_custom_domains BOOL
auto_assign_custom_domains_updated_by STRING
auto_expose_system_envs BOOL
created_at FLOAT64
crons__deployment_id STRING
crons__enabled_at FLOAT64
crons__updated_at FLOAT64
directory_listing BOOL
framework STRING
git_comments__on_commit BOOL
git_comments__on_pull_request BOOL
git_fork_protection BOOL
git_lfs BOOL
id STRING
link__type STRING
link__created_at FLOAT64
link__git_credential_id STRING
link__org STRING
link__production_branch STRING
link__repo STRING
link__repo_id FLOAT64
link__repo_owner_id FLOAT64
link__sourceless BOOL
link__updated_at FLOAT64
live BOOL
name STRING
node_version STRING
resource_config__function_default_memory_type STRING
serverless_function_region STRING
source_files_outside_root_directory BOOL
speed_insights__has_data BOOL
speed_insights__id STRING
sso_protection__deployment_type STRING
targets__production__type STRING
targets__production__alias_assigned FLOAT64
targets__production__building_at FLOAT64
targets__production__created_at FLOAT64
targets__production__created_in STRING
targets__production__creator__email STRING
targets__production__creator__github_login STRING
targets__production__creator__uid STRING
targets__production__creator__username STRING
targets__production__deployment_hostname STRING
targets__production__forced BOOL
targets__production__id STRING
targets__production__meta__branch_alias STRING
targets__production__meta__github_commit_author_login STRING
targets__production__meta__github_commit_author_name STRING
targets__production__meta__github_commit_message STRING
targets__production__meta__github_commit_org STRING
targets__production__meta__github_commit_ref STRING
targets__production__meta__github_commit_repo STRING
targets__production__meta__github_commit_repo_id STRING
targets__production__meta__github_commit_sha STRING
targets__production__meta__github_deployment STRING
targets__production__meta__github_org STRING
targets__production__meta__github_repo STRING
targets__production__meta__github_repo_id STRING
targets__production__meta__github_repo_owner_type STRING
targets__production__meta__github_repo_visibility STRING
targets__production__name STRING
targets__production__plan STRING
targets__production__preview_comments_enabled BOOL
targets__production__private BOOL
targets__production__ready_at FLOAT64
targets__production__ready_state STRING
targets__production__ready_substate STRING
targets__production__target STRING
targets__production__team_id STRING
targets__production__url STRING
targets__production__user_id STRING
targets__production__with_cache BOOL
updated_at FLOAT64
web_analytics__id STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
value JSON
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
type STRING
comment STRING
created_at FLOAT64
created_by STRING
id STRING
key STRING
updated_at FLOAT64
value STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
value STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
type STRING
alias_assigned FLOAT64
building_at FLOAT64
created_at FLOAT64
created_in STRING
creator__email STRING
creator__github_login STRING
creator__uid STRING
creator__username STRING
deployment_hostname STRING
forced BOOL
id STRING
meta__branch_alias STRING
meta__github_commit_author_login STRING
meta__github_commit_author_name STRING
meta__github_commit_message STRING
meta__github_commit_org STRING
meta__github_commit_ref STRING
meta__github_commit_repo STRING
meta__github_commit_repo_id STRING
meta__github_commit_sha STRING
meta__github_deployment STRING
meta__github_org STRING
meta__github_repo STRING
meta__github_repo_id STRING
meta__github_repo_owner_type STRING
meta__github_repo_visibility STRING
name STRING
plan STRING
preview_comments_enabled BOOL
private BOOL
ready_at FLOAT64
ready_state STRING
ready_substate STRING
target STRING
team_id STRING
url STRING
user_id STRING
with_cache BOOL
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: projects__latest_deployments__alias

Section titled “Subtable: projects__latest_deployments__alias”
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
value STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: projects__latest_deployments__automatic_aliases

Section titled “Subtable: projects__latest_deployments__automatic_aliases”
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
value STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: projects__latest_deployments__builds

Section titled “Subtable: projects__latest_deployments__builds”
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
value JSON
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
value JSON
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: projects__targets__production__alias

Section titled “Subtable: projects__targets__production__alias”
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
value STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: projects__targets__production__automatic_aliases

Section titled “Subtable: projects__targets__production__automatic_aliases”
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
value STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: projects__targets__production__builds

Section titled “Subtable: projects__targets__production__builds”
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
value JSON
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
teams (31 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
billing__billing_version FLOAT64
billing__currency STRING
billing__email STRING
billing__name STRING
billing__plan STRING
billing__plan_iteration STRING
billing__platform STRING
billing__status STRING
created STRING
created_at FLOAT64
created_direct_to_hobby BOOL
creator_id STRING
enabled_invoice_items__vercel_marketplace__enabled BOOL
id STRING
is_migrating_to_sensitive_env_vars BOOL
membership__confirmed BOOL
membership__created FLOAT64
membership__created_at FLOAT64
membership__role STRING
membership__team_id STRING
membership__updated_at FLOAT64
name STRING
remote_caching__enabled BOOL
resource_config__concurrent_builds FLOAT64
sensitive_environment_variable_policy STRING
slug STRING
spaces__enabled BOOL
staging_prefix STRING
updated_at FLOAT64
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
value JSON
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
teams_member (10 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
confirmed BOOL
created_at FLOAT64
email STRING
github__login STRING
role STRING
team_id STRING
uid STRING
username STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
value JSON
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
user (19 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
version STRING
billing__currency STRING
billing__plan STRING
billing__platform STRING
billing__status STRING
created_at FLOAT64
data_cache__excess_billing_enabled BOOL
default_team_id STRING
email STRING
has_trial_available BOOL
id STRING
import_flow_git_namespace_id FLOAT64
import_flow_git_provider STRING
remote_caching__enabled BOOL
resource_config__concurrent_builds FLOAT64
staging_prefix STRING
username STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
name STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: user__dismissed_toasts__dismissals

Section titled “Subtable: user__dismissed_toasts__dismissals”
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
created_at FLOAT64
scope_id STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

After the first load, Kaivo keeps your BigQuery warehouse up to date for you. Where Vercel supports it, each sync pulls only new and changed records so it stays fast; otherwise it refreshes the whole table. Every record keeps its original ID, so you won’t get duplicate rows.

How long does the initial sync take for Vercel?

Section titled “How long does the initial sync take for Vercel?”

It depends on how much history is in your Vercel account. Most initial syncs finish within minutes, while large accounts can take a few hours. After that, syncs only fetch new and changed records, so they’re much faster.

Yes. You pick which tables to sync when you set up the connection and can change the selection later. Tables you don’t select are never copied to your warehouse.

What happens when Vercel’s schema changes?

Section titled “What happens when Vercel’s schema changes?”

New fields are never added automatically. You choose which fields to sync, so data you haven’t selected (sensitive personal data, for example) never lands in your warehouse. When a new field appears, it becomes available for you to add. What happens to removed or renamed fields depends on a table’s sync mode: full-refresh tables always match what’s currently in Vercel, so dropped fields disappear, while incremental tables keep their existing columns and history, so an old field stays and newly added fields fill in over time.

How do I handle GDPR or data deletion requests?

Section titled “How do I handle GDPR or data deletion requests?”

Your data lives in your own Kaivo-managed BigQuery warehouse, so the most direct option is to delete or anonymise specific records right in BigQuery. If you delete data in Vercel instead, full-refresh tables drop it on the next sync, while incremental tables keep it, so you would remove the row in BigQuery or ask us to run a full refresh. To remove everything, delete the Vercel connector in Kaivo and all of its synced data is deleted with it.

Use deployments and deployment_events to track release frequency and outcomes over time.

Join projects with deployments to see which projects ship most often.

Bring teams and teams_member together to understand who deploys what.

Use deployment_events to spot failed deployments and patterns.

Once Vercel data lands in your Kaivo-managed BigQuery warehouse, you can explore it with AI tools or any BI tool that connects to BigQuery. Here’s how the most common destinations work with Vercel data.

Use Kaivo’s MCP server to give Claude secure, workspace-scoped access to your data. Setup guide →

Microsoft’s BI tool with a native BigQuery connector. Supports direct query and scheduled refresh. Setup guide →

Free Google BI tool with native BigQuery support. One-click connection to your Kaivo warehouse; great for SMB teams on Google Workspace. Setup guide →

The premium analytics standard, with native BigQuery integration. Setup guide →

Use Connected Sheets to query BigQuery directly from a spreadsheet, with no SQL. Setup guide →

Connect via Power Query’s BigQuery connector. Setup guide →

Open-source BI tool with strong BigQuery support. Setup guide →

See our pricing page for Vercel connector pricing and plan details.

  • Adform: Sync Adform to BigQuery.
  • Amplitude: Sync Amplitude to BigQuery.
  • Auth0: Sync Auth0 to BigQuery.
  • Convex: Sync Convex to BigQuery.
  • GitHub: Sync GitHub to BigQuery.
  • GitLab: Sync GitLab to BigQuery.