Overview

Cargo is the GTM system of record: companies, contacts, deals, and custom objects, stored, synced, and unified in one place, built for scale. Under the hood that data lives in a cloud data warehouse. Cargo ships a managed BigQuery by default; you can run the same system of record on top of your own BigQuery or Snowflake. That warehouse layer is why the models query with SQL and scale to billions of records. This page is how you connect and operate that warehouse. The cargo-ai system-of-record domain manages credentials, schema migrations, and cutover.

Connect a warehouse

Cargo ships with a default managed BigQuery warehouse, so you can start immediately. To bring your own warehouse, follow the setup guide for your provider — it walks through the permissions, credentials, and the Migrate flow under Settings → System of record:

BigQuery

Use Cargo’s default BigQuery or connect your existing Google Cloud project (service account, storage bucket, scope).

Snowflake

Connect your existing Snowflake instance (roles, RSA key, IP allowlist).

Once connected, manage the SOR lifecycle from the CLI.

Create and inspect

cargo-ai system-of-record sor list
cargo-ai system-of-record sor get <sor-uuid>
cargo-ai system-of-record sor create --kind <kind> --config '{ ... }'
cargo-ai system-of-record sor update --uuid <sor-uuid> --config '{ ... }'

Migrate and cut over

Schema changes are staged as a migration, then promoted with a cutover so live reads switch atomically:

cargo-ai system-of-record sor migrate <sor-uuid>   # stage a schema change
cargo-ai system-of-record sor cutover <sor-uuid>   # promote it live

Query the synced data

cargo-ai system-of-record client get-documentation <slug>      # queryable schema

Monitor sync health

cargo-ai system-of-record log list
cargo-ai system-of-record log get-metrics --from 2025-01-01 --to 2025-01-31

Using the UI

The workspace also surfaces SOR status, migrations, and sync logs visually — use the CLI for scripted setup and migrations, and the UI to review sync health at a glance.

Get started

Resources

Deploy

CLI

Skills

Reference

Connect a warehouse

BigQuery

Snowflake

Create and inspect

Migrate and cut over

Query the synced data

Monitor sync health

Using the UI

​Connect a warehouse

BigQuery

Snowflake

​Create and inspect

​Migrate and cut over

​Query the synced data

​Monitor sync health

​Using the UI

Connect a warehouse

Create and inspect

Migrate and cut over

Query the synced data

Monitor sync health

Using the UI