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

# Create dataset

> Creates a new dataset.

Creates a new dataset. Dataset names must be unique per user.

**Request body:**

```json theme={null}
{
  "name": "my-contracts"
}
```

| Field  | Required | Description                 |
| :----- | :------- | :-------------------------- |
| `name` | Yes      | Unique name for the dataset |

```bash theme={null}
curl -X POST https://api.allium.so/api/v1/beam/datasets \
  -H "X-API-Key: ${ALLIUM_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{ "name": "my-contracts" }'
```

**Response:**

```json theme={null}
{
  "id": "a1b2c3d4",
  "name": "my-contracts",
  "type": "postgres",
  "created_at": "2024-01-15T10:00:00Z",
  "updated_at": "2024-01-15T10:00:00Z"
}
```