---
title: "POST /v1/projects"
method: POST
path: "/v1/projects"
tags: ["projects"]
---

# POST /v1/projects

`POST /v1/projects`

## Request body

- object
  - `displayName` string, required
  - `externalId` string, nullable
  - `metadata` object, nullable
  - `maxConcurrentJobs` number, nullable
  - `globalConnectionExternalIds` string[]
  - `alertReceiverEmail` string, email, nullable

## Response `201`

Default Response

- Project
  - `id` string, required
  - `created` string, required
  - `updated` string, required
  - `ownerId` string, required
  - `displayName` string, required
  - `platformId` string, required
  - `maxConcurrentJobs` number, nullable
  - `type` 'TEAM' | 'PERSONAL', required
  - `icon` object, required
    - `color` 'RED' | 'BLUE' | 'YELLOW' | 'PURPLE' | 'GREEN' | 'PINK' | 'VIOLET' | 'ORANGE' | 'DARK_GREEN' | 'CYAN' | 'LAVENDER' | 'DEEP_ORANGE', required
  - `externalId` string, nullable
  - `releasesEnabled` boolean, required
  - `metadata` object, nullable
  - `poolId` string, nullable
  - `plan` object, required
    - `id` string, required
    - `created` string, required
    - `updated` string, required
    - `projectId` string, required
    - `locked` boolean, required
    - `name` string, required
    - `piecesFilterType` 'NONE' | 'ALLOWED', required
    - `pieces` string[], required
  - `analytics` object, required
    - `totalUsers` number, required
    - `activeUsers` number, required
    - `totalFlows` number, required
    - `activeFlows` number, required

---

[API](https://skmtc.dev/activepieces/apis/activepieces-documentation.md) · [All operations](https://skmtc.dev/activepieces/apis/activepieces-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/activepieces/activepieces-documentation/revisions/745e4b7f764a/schema)