---
title: "Create import upload REST API | HitKeep"
description: "Reference for the HitKeep REST API operation Create import upload, including request parameters, responses, and authentication notes."
canonical: "https://hitkeep.com/api/operations/apisitesidimportsprovideruploads/"
---

# Create import upload REST API

POST

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

FetchcURL

```
const url = 'http://127.0.0.1:25737/api/sites/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/imports/plausible/uploads';
const options = {
  method: 'POST',
  headers: {cookie: 'hk_token=<hk_token>', 'Content-Type': 'application/json'},
  body: '{"files":[{"filename":"example","sha256":"example","size_bytes":1}]}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```
curl --request POST \
  --url http://127.0.0.1:25737/api/sites/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/imports/plausible/uploads \
  --header 'Content-Type: application/json' \
  --cookie hk_token=<hk_token> \
  --data '{ "files": [ { "filename": "example", "sha256": "example", "size_bytes": 1 } ] }'
```

-

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

## Authorizations

- **[cookieAuth](https://hitkeep.com/api/#cookieauth)**
- **[bearerAuth](https://hitkeep.com/api/#bearerauth)**
- **[apiKeyAuth](https://hitkeep.com/api/#apikeyauth)**

## Parameters

### Path Parameters

**id**

required

string format: uuid

**provider**

required

string

Allowed values: plausible simpleanalytics

## Request Bodyrequired

application/json

object

**files**

required

Array<object>

object

**filename**

required

string

**sha256**

Optional lowercase or uppercase hex SHA-256 checksum for the staged file.

string

**size_bytes**

required

integer

##### Examplegenerated

```
{
  "files": [
    {
      "filename": "example",
      "sha256": "example",
      "size_bytes": 1
    }
  ]
}
```

## Responses

### 200

Upload session

application/json

object

***key***

additional properties

any

##### Examplegenerated

```
{}
```

### 400

Invalid upload

application/json

object

**message**

string

##### Examplegenerated

```
{
  "message": "example"
}
```

### 413

Import exceeds maximum staged size

application/json

object

**message**

string

##### Examplegenerated

```
{
  "message": "example"
}
```

[Previous Start validated import](https://hitkeep.com/api/operations/apisitesidimportsimportidstart/)[Next Overview](https://hitkeep.com/api/operations/tags/goals/)