---
title: "Create reference table upload"
method: POST
path: "/api/v2/reference-tables/uploads"
tags: ["Reference Tables"]
---

# Create reference table upload

`POST /api/v2/reference-tables/uploads`

Create a reference table upload for bulk data ingestion

## Request body

- CreateUploadRequest — Request to create an upload for a file to be ingested into a reference table.
  - `data` CreateUploadRequestData — Request data for creating an upload for a file to be ingested into a reference table.
    - `attributes` CreateUploadRequestDataAttributes — Upload configuration specifying how data is uploaded by the user, and properties of the table to associate the upload with.
      - `headers` string[], required — The CSV file headers that define the schema fields, provided in the same order as the columns in the uploaded file.
      - `part_count` integer, required — Number of parts to split the file into for multipart upload.
      - `part_size` integer, required — The size of each part in the upload in bytes. All parts except the last one must be at least 5,000,000 bytes.
      - `table_name` string, required — Name of the table to associate with this upload.
    - `type` 'upload', required — Upload resource type.

## Response `201`

Created

- CreateUploadResponse — Information about the upload created containing the upload ID and pre-signed URLs to PUT chunks of the CSV file to.
  - `data` CreateUploadResponseData — Upload ID and attributes of the created upload.
    - `attributes` CreateUploadResponseDataAttributes — Pre-signed URLs for uploading parts of the file.
      - `part_urls` string[] — The pre-signed URLs for uploading parts. These URLs expire after 5 minutes.
    - `id` string — Unique identifier for this upload. Use this ID when creating the reference table.
    - `type` 'upload', required — Upload resource type.

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `429` — Too many requests

---

[API](https://skmtc.net/datadog/apis/api-v2.md) · [All operations](https://skmtc.net/datadog/apis/api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/datadog/api-v2/versions/da68bf029e4c/schema)