Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.getcargo.ai/llms.txt

Use this file to discover all available pages before exploring further.

Data models are structured tables that power your Cargo plays. They contain organized data that can be imported into plays to create runs. Cargo lets you build data models from data you own — native object models for accounts, contacts, deals, leads, and any custom entity — and from data you sync — integrations, webhooks, files, and SQL queries — then merges everything into unified, deduplicated views of your customers.
Cargo uses a data warehouse infrastructure to host your data models. By default, you’ll get a managed Snowflake instance, or you can connect your own warehouse.

​
Model types

Cargo organizes data models into three categories. They live side-by-side in the same warehouse and can be queried, joined, and used as triggers in the same way — what differs is who owns the schema and who writes the records.

Object

Native, writable models you own — Account, Contact, Deal, Lead, or a fully custom schema. Plays, tools, and agents insert, update, and remove records directly.

Integration

Models populated from an external source — CRMs, enrichment APIs, webhooks, SQL queries, file uploads. Cargo syncs the data; the source system stays the source of truth.

Unified

Read-only Account, Contact, Account Event, and Contact Event models that deduplicate records across all integration and object sources.
Model typeSchema ownerWritable from a workflowTypical use
ObjectYou (built-in or custom)✅ YesSourced lists, internal pipelines, custom entities
IntegrationThe connected source❌ Use the integration’s write actionsMirror CRM, warehouse, webhook, or file data
UnifiedCargo❌ Read-onlySingle deduplicated view of accounts, contacts, events

​
Data connectors

Cargo offers three types of data loaders to populate integration models with external data:
ConnectorDescription
Native integrationsConnect to supported external APIs (CRMs, enrichment tools, etc.) and fetch data directly into a data model.
Webhook loaderListen for real-time events from external sources and import that data automatically.
SQL loaderRun SQL queries on your data warehouse tables and import the results.
For data Cargo itself owns — sourced leads, internal pipelines, agent outputs, custom entities — use object models instead.

​
Data model capabilities

Data models support powerful capabilities to help you orchestrate your GTM workflows:
Apply filters to create targeted segments for specific plays based on custom criteria.
Enable plays to respond in real-time to updates, additions, or deletions in your data.
Track processed records to prevent plays from handling the same data multiple times.
Connect different data models using common identifiers to create unified views of your customer data.
Extend your data models with calculated fields and custom data: - Custom columns: Free-form columns you can upsert from within a play - Computed columns: Calculated values based on other columns in the data model - Metrics columns: Aggregated data (sums, averages, counts) from related data models

​
Use cases

Data models power a wide range of GTM scenarios:
Use caseDescription
CRM syncImport customer information, deal pipelines, and sales activities from Salesforce or HubSpot to create unified customer profiles.
Intent signalsCapture website behavior, form submissions, and engagement metrics to identify prospects showing buying intent.
List buildingAggregate contact lists from marketing campaigns, events, and lead generation activities for targeted outreach.
Product analyticsQuery product catalogs, usage analytics, and inventory levels to inform customer interactions.

​
Next steps

Object models

Define writable models for accounts, contacts, deals, leads, and custom objects.

Unification

See how Cargo merges records into single Account, Contact, and Event models.

Querying data

Write custom SQL queries to transform and combine your data.

Storage actions

Use model search, record, and custom column actions.

Warehouse setup

Connect your own data warehouse as the backbone of your data models.

Files

Work with unstructured data like documents and PDFs.