---
title: "Create a project"
method: POST
path: "/v1/projects"
tags: ["Projects"]
---

# Create a project

`POST /v1/projects`

## Request body

- V1CreateProjectBody
  - `db_pass` string, required — Database password
  - `name` string, required — Name of your project
  - `organization_id` string — Deprecated: Use `organization_slug` instead.
  - `organization_slug` string, required — Organization slug
  - `plan` 'free' | 'pro' — Subscription Plan is now set on organization level and is ignored in this request
  - `region` 'us-east-1' | 'us-east-2' | 'us-west-1' | 'us-west-2' | 'ap-east-1' | 'ap-southeast-1' | 'ap-northeast-1' | 'ap-northeast-2' | 'ap-southeast-2' | 'eu-west-1' | 'eu-west-2' | 'eu-west-3' | 'eu-north-1' | 'eu-central-1' | 'eu-central-2' | 'ca-central-1' | 'ap-south-1' | 'sa-east-1' — Region you want your server to reside in. Use region_selection instead.
  - `region_selection` union — Region selection. Only one of region or region_selection can be specified.
    - object
      - `type` 'specific', required
      - `code` 'us-east-1' | 'us-east-2' | 'us-west-1' | 'us-west-2' | 'ap-east-1' | 'ap-southeast-1' | 'ap-northeast-1' | 'ap-northeast-2' | 'ap-southeast-2' | 'eu-west-1' | 'eu-west-2' | 'eu-west-3' | 'eu-north-1' | 'eu-central-1' | 'eu-central-2' | 'ca-central-1' | 'ap-south-1' | 'sa-east-1', required — Specific region code. The codes supported are not a stable API, and should be retrieved from the /available-regions endpoint.
    - object
      - `type` 'smartGroup', required
      - `code` 'americas' | 'emea' | 'apac', required — The Smart Region Group's code. The codes supported are not a stable API, and should be retrieved from the /available-regions endpoint.
  - `kps_enabled` boolean — This field is deprecated and is ignored in this request
  - `desired_instance_size` 'nano' | 'micro' | 'small' | 'medium' | 'large' | 'xlarge' | '2xlarge' | '4xlarge' | '8xlarge' | '12xlarge' | '16xlarge' | '24xlarge' | '24xlarge_optimized_memory' | '24xlarge_optimized_cpu' | '24xlarge_high_memory' | '48xlarge' | '48xlarge_optimized_memory' | '48xlarge_optimized_cpu' | '48xlarge_high_memory' — Desired instance size. Omit this field to always default to the smallest possible size.
  - `template_url` string, uri — Template URL used to create the project from the CLI.
  - `high_availability` boolean — [Experimental] Whether to enable high availability for the project.

## Response `201`

- V1ProjectResponse
  - `id` string, required — Deprecated: Use `ref` instead.
  - `ref` string, required — Project ref
  - `organization_id` string, required — Deprecated: Use `organization_slug` instead.
  - `organization_slug` string, required — Organization slug
  - `name` string, required — Name of your project
  - `region` string, required — Region of your project
  - `created_at` string, required — Creation timestamp
  - `status` 'INACTIVE' | 'ACTIVE_HEALTHY' | 'ACTIVE_UNHEALTHY' | 'COMING_UP' | 'UNKNOWN' | 'GOING_DOWN' | 'INIT_FAILED' | 'REMOVED' | 'RESTORING' | 'UPGRADING' | 'PAUSING' | 'RESTORE_FAILED' | 'RESTARTING' | 'PAUSE_FAILED' | 'RESIZING', required

## Other responses

- `401` — Unauthorized
- `403` — Forbidden action
- `429` — Rate limit exceeded

---

[API](https://skmtc.net/supabase/apis/management-api.md) · [All operations](https://skmtc.net/supabase/apis/management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/supabase/management-api/versions/a7cb39418064/schema)