---
title: "Create Project"
method: POST
path: "/api/v1/projects"
tags: ["Project", "project"]
---

# Create Project

`POST /api/v1/projects`

## Request

- Base URL: `https://mockupper.damdafa.com/mockupper`
- URL: `https://mockupper.damdafa.com/mockupper/api/v1/projects`
- Auth: HTTP bearer

Create a new project.
Enforces project limits based on user subscription.

## Headers

- `ProviderId` 'firebase' | 'google' | 'apple'
- `X-Provider-Id` 'firebase' | 'google' | 'apple'
- `X-Device-Id` string, nullable

## Request body

- ProjectCreate
  - `title` string, required
  - `coverImage` string, nullable
  - `logoImage` string, nullable
  - `appStoreProfileId` string, nullable
  - `appStoreAppId` string, nullable
  - `managerIds` string[]

## Response `201`

Successful Response

- Project: Represents a document in the 'projects' root collection.
  - `title` string, required
  - `coverImage` string, nullable
  - `logoImage` string, nullable
  - `appStoreProfileId` string, nullable
  - `appStoreAppId` string, nullable
  - `managerIds` string[]
  - `id` string, required
  - `userId` string, required
  - `status` 'in_progress' | 'completed' | 'archived'
  - `currentVersionString` string, nullable
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/damdafa/apis/mockupper-api.md) · [All operations](https://skmtc.dev/damdafa/apis/mockupper-api/llms.txt) · [OpenAPI document](https://skmtc.dev/damdafa/apis/mockupper-api/revisions/5713d43bfed1?raw)