> For the complete documentation index, see [llms.txt](https://support.sayprimer.com/primer/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.sayprimer.com/primer/connections/datasets.md).

# Datasets

Bring your own people and company lists into Primer as datasets — import a CSV, upload via S3, or push over the API — and read their status and enrichment numbers.

A dataset is your own list of people or companies, brought into Primer so you can [filter audiences](https://support.sayprimer.com/primer/audiences/audience-filters.md) against it. Alongside a [CRM connection](https://support.sayprimer.com/primer/connections/integrations/connecting-a-crm.md), there are three ways to load one:

* [**Importing a CSV**](https://support.sayprimer.com/primer/connections/datasets/importing-a-csv.md) — upload a file in the app. It also lists the fields Primer recognizes.
* [**Uploading via S3**](https://support.sayprimer.com/primer/connections/datasets/uploading-via-s3.md) — drop CSVs into a Primer S3 location for scheduled loads from a warehouse or pipeline.
* [**Pushing via API**](https://support.sayprimer.com/primer/connections/datasets/pushing-via-api.md) — send records over HTTP from your own systems.

## How each method updates a dataset

* **In the app**, every upload creates a new dataset; file names must be unique.
* **Over S3**, the file name identifies the dataset. Dropping a file with the same name replaces that dataset completely — records missing from the new file are dropped. A file with a new name creates a new dataset alongside the old one.
* **Over the API**, records are added to a named dataset. A record replaces the earlier record with the same ID; records you don't send again stay.

## Datasets on CSV Imports

Every dataset, however it arrived, is listed under **Connections → CSV Imports**, with an icon showing whether it was uploaded, dropped over S3 or sent over the API. The last column shows **processing** while Primer loads it, **Failed** if it couldn't be loaded (hover for the reason), and otherwise when it was imported. There is no delete control on this tab.

Once loaded, each dataset shows **Records**, **Enrich rate**, **Available**, **Duplicates** and **Audiences**. Enrich rate, Available and Duplicates mean the same as for a CRM — see [Enrichment after each sync](https://support.sayprimer.com/primer/connections/integrations/connecting-a-crm.md#enrichment-after-each-sync). Two columns are specific to datasets:

* **Records** — every record you provided. For an API dataset, this is everything sent to it so far, not just the latest send.
* **Audiences** — how many active audiences use the dataset.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://support.sayprimer.com/primer/connections/datasets.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
