---
title: "Create New Data Store"
method: POST
path: "/v1/data-discovery/data-stores"
tags: ["dataDiscovery"]
---

# Create New Data Store

`POST /v1/data-discovery/data-stores`

## Request

- Base URL: `https://api.osano.com`
- URL: `https://api.osano.com/v1/data-discovery/data-stores`
- Auth: API key in header `x-osano-api-key`
- TypeScript: <https://skmtc.dev/osano/apis/osano-api-reference/docs/v1/data-discovery/data-stores/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a new Data Store using the provided parameters.  If successful, the created Data Store will be returned.

## Request body

- DataStore
  - `name` string, required
  - `description` string
  - `alias` string
  - `connectorId` integer
  - `owners` DataStoreOwner[]
    - `email` string, email, required
    - `primary` boolean

## Response `200`

Success

- DataStoreResponse
  - `dataStoreId` integer
  - `name` string
  - `status` string, nullable: The sync status of the data store (e.g., QUEUED, SYNCED, FAILED). Null for internal data stores.
  - `lastSync` string, date-time, nullable: The timestamp of the last sync operation
  - `description` string
  - `alias` string
  - `type` string
  - `active` boolean
  - `created` string, date-time
  - `connector` Connector
    - `connectorId` integer, required
    - `productName` string, required
    - `authType` string, required
  - `owners` DataStoreOwner[]
    - `email` string, email, required
    - `primary` boolean
  - `totalFields` integer: Total count of fields in the data store
  - `unclassifiedFields` integer: Count of fields that have not been classified
  - `fieldsWithUserData` integer: Count of fields that contain user data
  - `metadata` object
  - `labels` DataStoreLabels[]
    - `name` string, required
    - `labelId` string, uuid, nullable

## Other responses

- `400`: Bad Request

## Changes

- **2026-05-12** `4fc37598750d`: 1 breaking, 1 warning, 7 info
  - the `owners/items/email` request property's minLength was increased from `0` to `5`
  - the `owners/items/email` request property's maxLength was set to `100`
  - added the optional property `fieldsWithUserData` to the response with the `200` status
  - added the optional property `labels` to the response with the `200` status
  - …5 more

[Operation history](https://skmtc.dev/osano/apis/osano-api-reference/changes/v1/data-discovery/data-stores/post.md)

---

[API](https://skmtc.dev/osano/apis/osano-api-reference.md) - [All operations](https://skmtc.dev/osano/apis/osano-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/osano/apis/osano-api-reference/revisions/ac31099cf83e?raw)