Create a project

Create a new Pinecone project in the console or through the Admin API, add tags, and optionally enable a customer-managed encryption key (CMEK).

This page shows you how to create a project.

If you are an organization owner or organization manager, you can create a project in your organization:

In the Pinecone console, go to your profile > Organization settings > Projects.
Click + Create Project.
Enter a Name.A project name can contain up to 512 characters. For more information, see Object identifiers.
(Optional) Tags are key-value pairs that you can use to categorize and identify the project. To add a tag, click + Add tag and enter a tag key and value.
(Optional) Select Encrypt with Customer Managed Encryption Key. For more information, see Configure CMEK.
Click Create project.
To load an index with a sample dataset, click Load sample data and follow the prompts.

curl

PINECONE_ACCESS_TOKEN="YOUR_ACCESS_TOKEN"

curl "https://api.pinecone.io/admin/projects" \
    -H "X-Pinecone-Api-Version: 2026-07" \
	-H "Authorization: Bearer $PINECONE_ACCESS_TOKEN" \
	-d '{
          "name":"example-project"
        }'

CLI

# Target the organization for which you want to 
# create a project.
pc target -o "example-org"
# Create the project and set it as the target 
# project for the CLI.
pc project create -n "example-project" --target

The example returns a response like the following:

curl

{
  "id": "32c8235a-5220-4a80-a9f1-69c24109e6f2",
  "name": "example-project",
  "max_pods": 0,
  "force_encryption_with_cmek": false,
  "organization_id": "-NM7af6f234168c4e44a",
  "created_at": "2025-03-16T22:46:45.030Z"
}

CLI

[SUCCESS] Project example-cli-project created successfully.

ATTRIBUTE           VALUE
Name                example-project
ID                  32c8235a-5220-4a80-a9f1-69c24109e6f2
Organization ID     -NM7af6f234168c4e44a
Created At          2025-10-27 23:27:46.370088 +0000 UTC
Force Encryption    false
Max Pods            5

[SUCCESS] Target project set to example-cli-project

Next steps