> ## Documentation Index
> Fetch the complete documentation index at: https://docs.docyard.cc/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Upload

> Create a new upload endpoint

# Create Upload

Create a new upload endpoint for uploading artifacts.

## Endpoint

```
POST /upload endpoints
```

## Request

```bash theme={null}
curl -X POST https://api.docyard.io/v1/upload endpoints \
  -H "X-API-Key: dk_live_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Production Upload",
    "description": "Main upload endpoint for insurance declarations"
  }'
```

## Response

```json theme={null}
{
  "upload endpoint_id": "upload endpoint-new-001",
  "name": "Production Upload",
  "description": "Main upload endpoint for insurance declarations",
  "status": "active",
  "api_key": "dk_live_dist_aaaaaaaa",
  "api_secret": "dk_secret_dist_bbbbbbbb",
  "created_at": "2026-03-15T10:00:00Z"
}
```

**Important**: Save the `api_key` and `api_secret` securely. The secret is only shown once.

***

## Related Endpoints

* \[List Uploads]\(/api-reference/upload endpoints/list)
* \[Rotate Keys]\(/api-reference/upload endpoints/rotate-keys)