Create a project ↗
noOriginal Documentation
Documentation Index#
Fetch the complete documentation index at: https://docs.pinecone.io/llms.txt Use this file to discover all available pages before exploring further.
Create a new Pinecone project in your organization.
This page shows you how to create a project.
If you are an organization owner or user, 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.
Organizations on the Starter plan are limited to one project. To create additional projects, upgrade to the Standard or Enterprise plan.
An access token must be provided to complete this action through the Admin API. The Admin API is in public preview.
PINECONE_ACCESS_TOKEN="YOUR_ACCESS_TOKEN"
curl "https://api.pinecone.io/admin/projects" \
-H "X-Pinecone-Api-Version: 2025-10" \
-H "Authorization: Bearer $PINECONE_ACCESS_TOKEN" \
-d '{
"name":"example-project"
}'
```
```bash
# 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:
```json
{
"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"
}
```
```text
[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
```
<span class="tab-end"></span>
<span class="tab-group-end"></span>
## Next steps
* [Add users to your project](/guides/projects/manage-project-members#add-members-to-a-project)
* [Create an index](/guides/index-data/create-an-index)