# CSV Exports

> Download your leads as a CSV: choose the sources and exactly which fields go in the file.

Every section below does the same job: in the dashboard (Guide), from your code (API) or through an AI assistant (MCP).

## Guide — In the dashboard

Source: /docs/leads/csv-export

Export any of your leads to a CSV, with the fields you choose. Works for every Leads tab, not only Website Visitors.

<DemoFrame guide="leads-csv-export" to="/identify/{workspace}?tab=visitors" />

1. **Export to CSV** at the top of Leads.
2. **Which leads:** tick the sources — Website Visitors, 3rd-Party Intent, Web Scraping, Prospector, AI Scout.
3. **Which fields:** search, tick a whole group (Contact, Company, Activity…) or single fields. Your choice is remembered for next time.
4. **Export CSV.** The file is built in the background, emailed to you and kept under **CSV Exports** for 30 days.

### Every control on this screen [#every-control-on-this-screen]

Every button, field and switch, with what it does.

<ScreenControls screens={["leads-exports", "leads-export-modal"]} />


---

## API — From your code

Source: /docs/leads/csv-export/api

Authenticated with `?privateKey=YOUR_KEY` (see [Authentication](/docs/authentication)).

<Endpoints ops={["POST /v3/leads/export"]} />

<ApiPlayground
  ops={["POST /v3/leads/export"]}
  method="post"
  path="/v3/leads/export"
  tool="export_leads_csv"
  args={`{
  "websiteId": "64b7f0a1c2d3e4f5a6b7c8d9",
  "dateFrom": "2026-10-01",
  "dateTo": "2026-10-30"
}`}
/>

### Use case: A monthly export [#use-case-a-monthly-export]

`POST /v3/leads/export` with the month as `dateFrom`/`dateTo`. The download link is emailed to you.


---

## MCP — AI agents

Source: /docs/leads/csv-export/mcp

Connect the [MCP server](/docs/mcp#quickstart), then just ask.

<Tools names={["export_leads_csv"]} />

### Use case [#use-case]

> Export this month’s leads to CSV.

<McpToolCall name="export_leads_csv">

```json
{
  "websiteId": "64b7f0a1c2d3e4f5a6b7c8d9",
  "dateFrom": "2026-10-01",
  "dateTo": "2026-10-30"
}
```

</McpToolCall>