---
title: "Create datastore"
method: POST
path: "/api/v2/actions-datastores"
tags: ["Actions Datastores"]
---

# Create datastore

`POST /api/v2/actions-datastores`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/actions-datastores`
- Auth: API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`

Creates a new datastore.

## Request body

- CreateAppsDatastoreRequest: Request to create a new datastore with specified configuration and metadata.
  - `data` CreateAppsDatastoreRequestData: Data wrapper containing the configuration needed to create a new datastore.
    - `attributes` CreateAppsDatastoreRequestDataAttributes: Configuration and metadata to create a new datastore.
      - `description` string: A human-readable description about the datastore.
      - `name` string, required: The display name for the new datastore.
      - `org_access` 'contributor' | 'viewer' | 'manager': The organization access level for the datastore. For example, 'contributor'.
      - `primary_column_name` string, required: The name of the primary key column for this datastore. Primary column names: - Must abide by both [PostgreSQL naming conventions](https://www.postgresql.org/docs/7.0/syntax525.htm) - Cannot exceed 63 characters
      - `primary_key_generation_strategy` 'none' | 'uuid': Can be set to `uuid` to automatically generate primary keys when new items are added. Default value is `none`, which requires you to supply a primary key for each new item.
    - `id` string: Optional ID for the new datastore. If not provided, one will be generated automatically.
    - `type` 'datastores', required: The resource type for datastores.

## Response `200`

OK

- CreateAppsDatastoreResponse: Response after successfully creating a new datastore, containing the datastore's assigned ID.
  - `data` CreateAppsDatastoreResponseData: The newly created datastore's data.
    - `id` string: The unique identifier assigned to the newly created datastore.
    - `type` 'datastores', required: The resource type for datastores.

## Other responses

- `400`: Bad Request
- `429`: Too many requests

---

[API](https://skmtc.dev/datadog/apis/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/da68bf029e4c?raw)