Skip to main content

​
How to set up CSV

​
Authentication

The CSV integration requires no authentication:
  1. Search for the CSV integration in the settings panel or the node catalog
  2. Create the connector by giving it a name and slug — no credentials are needed
Code slugs — integration slug: csv. This integration has no actions; it provides one extractor, upload, used when creating or syncing a model from a file.

​
Data models

The CSV integration is a data source, not an action provider: it exposes an Upload extractor that imports the rows of a CSV file as records into a Cargo data model. When configuring an upload:
  • File: The CSV file to import (CSV only, max 2GB)
  • ID: The column used to deduplicate records
  • Mappings (optional): Map file columns to the column names of your model; if you use mappings, the ID column must be included in them
Cargo previews the first rows of the file so you can validate the mapping before running the full import. Uploads are one-shot fetches — re-upload a file to refresh the data.

​
Best practices

  • Pick a genuinely unique column (email, external ID) as the ID to avoid collapsing distinct records during deduplication
  • Use mappings to normalize messy header names into clean model column slugs
  • Keep files under the 2GB limit; split very large exports into multiple uploads
  • Re-run the upload extractor with a fresh file to update the model — imports are not incremental