---
title: "Upload CSV"
method: POST
path: "/api/v2/powerdialer/csv"
tags: ["CSV"]
---

# Upload CSV

`POST /api/v2/powerdialer/csv`

## Request

- Base URL: `https://dialpad.com`
- URL: `https://dialpad.com/api/v2/powerdialer/csv`
- Auth: HTTP bearer

Upload a CSV and create a Csv entity

## Request body `multipart/form-data`

- object
  - `file` string, binary: The file to upload
  - `name` string: Optional name for the file

## Response `200`

Default Response

- Csv
  - `author_dp_key` string, nullable
  - `author_id` string
  - `author_key` string
  - `columns` unknown[]
    - unknown
  - `company_id` integer, required
  - `csv_id` string, required
  - `custom_mapping` CustomMapping
  - `date_created` integer
  - `date_created_iso` string
  - `date_modified` integer
  - `date_modified_iso` string
  - `download_url` string
  - `file_type` 'CSV' | 'XLSX'
  - `filename` string
  - `gcs_filename` string, nullable
  - `id` string, required
  - `import_results` ImportResults
    - `collisions` integer: number of rows failed to acquire a lock
    - `created` integer: number of new leads created
    - `duplicates` integer: number of duplicate rows skipped
    - `failed_batches` integer: number of batch exceptions
    - `skipped` integer: number of invalid rows skipped
    - `total` integer: total leads associated with list at import-time
    - `updated` integer: number of existing leads updated
  - `key` string, required
  - `labels` unknown[]
    - unknown
  - `lead_mapping` LeadMapping
  - `name` string
  - `num_rows` integer, nullable
  - `office_id` integer, nullable: office_id that owns this CSV
  - `sort_name` string, nullable
  - `state` 'pending' | 'launching' | 'scheduled' | 'active' | 'paused' | 'complete' | 'error' | 'deleted' | 'cancelled'
  - `strategy` 'skip' | 'merge': The strategy to use when de-duping a csv at import time
  - `tags` unknown[]
    - unknown

## Other responses

- `400`: Default Response

---

[API](https://skmtc.dev/dialpad/apis/powerdialer.md) - [All operations](https://skmtc.dev/dialpad/apis/powerdialer/llms.txt) - [OpenAPI document](https://skmtc.dev/dialpad/apis/powerdialer/revisions/010f45688a85?raw)