---
title: "Create project"
method: POST
path: "/teams/{team_id}/create_project"
tags: ["Projects"]
---

# Create project

`POST /teams/{team_id}/create_project`

Create a new project on a team, optionally provisioning a dev or prod
deployment.

## Path parameters

- `team_id` integer, required

## Request body

- PlatformCreateProjectArgs
  - `projectName` string, required
  - `deploymentType` 'dev' | 'prod' | 'preview' | 'custom'
  - `deploymentClass` string, nullable — When creating a deployment, the class to use for the deployment. If not provided, the default deployment class for your team will be used.
  - `deploymentRegion` 'aws-us-east-1' | 'aws-eu-west-1'

## Response `200`

- PlatformCreateProjectResponse
  - `projectId` integer, required
  - `id` integer, required
  - `slug` string, required
  - `deploymentName` string, nullable — The readable identifier for this deployment, something like playful-otter-123. Only present when a deployment was requested.
  - `deploymentUrl` string, nullable — Deployment cloud URL, where this deployment lives. Only present when a deployment was requested.

---

[API](https://skmtc.dev/convex/apis/convex-management-api.md) · [All operations](https://skmtc.dev/convex/apis/convex-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/convex/convex-management-api/revisions/3dd5e601c536/schema)