---
title: "Create a collection"
method: POST
path: "/collections"
tags: ["Manage Indexes"]
---

# Create a collection

`POST /collections`

Create a Pinecone collection.
  
Serverless indexes do not support collections.

## Headers

- `X-Pinecone-Api-Version` string, required

## Request body

- DbControlCreateCollectionRequest — The configuration needed to create a Pinecone collection.
  - `name` string, required — The name of the collection to be created. Resource name must be 1-45 characters long, start and end with an alphanumeric character, and consist only of lower case alphanumeric characters or '-'.
  - `source` string, required — The name of the index to be used as the source for the collection.

## Response `201`

The collection has been successfully created.

- DbControlCollectionModel — The CollectionModel describes the configuration and status of a Pinecone collection.
  - `name` string, required — The name of the collection.
  - `size` integer — The size of the collection in bytes.
  - `status` string, required — The status of the collection. Possible values: `Initializing`, `Ready`, or `Terminating`.
  - `dimension` integer — The dimension of the vectors stored in each record held in the collection.
  - `vector_count` integer — The number of records stored in the collection.
  - `environment` string, required — The environment where the collection is hosted.

## Other responses

- `400` — Bad request. The request body included invalid request parameters.
- `401` — Unauthorized. Possible causes: Invalid API key.
- `402` — Payment required. Organization is on a paid plan and is delinquent on payment.
- `403` — You've exceed your collections quota.
- `409` — Collection of given name already exists.
- `422` — Unprocessable entity. The request body could not be deserialized.
- `500` — Internal server error.

---

[API](https://skmtc.net/pinecone/apis/pinecone-api.md) · [All operations](https://skmtc.net/pinecone/apis/pinecone-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pinecone/pinecone-api/revisions/35876583485d/schema)