---
title: "Create import upload"
method: POST
path: "/api/sites/{id}/imports/{provider}/uploads"
tags: ["Imports"]
---

# Create import upload

`POST /api/sites/{id}/imports/{provider}/uploads`

## Request

- Base URL: `https://demo.hitkeep.com`
- URL: `https://demo.hitkeep.com/api/sites/{id}/imports/{provider}/uploads`
- Auth: one of:
  - API key in cookie `hk_token`
  - HTTP bearer
  - API key in header `X-API-Key`

Creates a staged import upload session. Use chunk upload endpoints to send the declared ZIP or CSV files.

## Path parameters

- `id` string, uuid, required
- `provider` 'plausible' | 'simpleanalytics', required

## Request body

- object
  - `files` object[], required
    - `filename` string, required
    - `sha256` string: Optional lowercase or uppercase hex SHA-256 checksum for the staged file.
    - `size_bytes` integer, required

## Response `200`

Upload session

- object

## Other responses

- `400`: Invalid upload
- `413`: Import exceeds maximum staged size

---

[API](https://skmtc.dev/hitkeep/apis/hitkeep-rest-api.md) · [All operations](https://skmtc.dev/hitkeep/apis/hitkeep-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hitkeep/apis/hitkeep-rest-api/revisions/bb2df36ab2a4?raw)