---
title: "Create a new project"
method: POST
path: "/organization/{org-slug-or-id}/project"
tags: ["Project"]
---

# Create a new project

`POST /organization/{org-slug-or-id}/project`

Create a new project. Works for all organization types.

## Path parameters

- `org-slug-or-id` string, required

## Request body

- object
  - `name` string, required — The name of the project

## Response `200`

The new project

- object — NOTE: The definition of Project is subject to change.
  - `slug` string, required — Project slug in the form `vcs-slug/org-name/repo-name`. The `/` characters may be URL-escaped. For projects that use GitLab or GitHub App, use `circleci` as the `vcs-slug`, replace `org-name` with the organization ID (found in Organization Settings), and replace `repo-name` with the project ID (found in Project Settings).
  - `name` string, required — The name of the project
  - `id` string, uuid, required
  - `organization_name` string, required — The name of the organization the project belongs to
  - `organization_slug` string, required — The slug of the organization the project belongs to
  - `organization_id` string, uuid, required — The id of the organization the project belongs to
  - `vcs_info` object, required — Information about the VCS that hosts the project source code.
    - `vcs_url` string, required — URL to the repository hosting the project's code
    - `provider` 'Bitbucket' | 'CircleCI' | 'GitHub', required — The VCS provider
    - `default_branch` string, required

## Other responses

- `default` — Error response.

---

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