---
title: "Create a new project in given workspace"
method: POST
path: "/workspaces/{workspace_id}/projects"
tags: ["Projects"]
---

# Create a new project in given workspace

`POST /workspaces/{workspace_id}/projects`

## Request

- Base URL: `https://app.mammoth.io/api/v2`
- URL: `https://app.mammoth.io/api/v2/workspaces/{workspace_id}/projects`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-KEY` and API key in header `X-API-SECRET` and API key in header `X-WORKSPACE-ID`

Creates new projects and add user as owner of the project.

## Path parameters

- `workspace_id` integer, required: Workspace refers to a collection of projects. Workspace ID is unique identifier for workspace.

## Request body

- ProjectCreate: Name of project to be created
  - `name` string, required: Name of project to be created
  - `properties` ProjectProperties, required: Properties of project
    - `color` string: Color of project
    - `date_format` 'US' | 'UK'
    - `display_date_format` string, nullable: Default display format for date columns in datasets and dataviews created within this project
    - `project_access` 'all_members_of_workspace' | 'some_members_of_workspace' | 'only_me': Project access level

## Response `201`

Successful create

- ProjectSchema
  - `id` integer, nullable: unique identifier representing project
  - `name` string, nullable: Name of project
  - `owner_workspace_id` integer, nullable: Parent Workspace id
  - `updated_at` string, date-time, nullable: Time when last update to project has happened
  - `created_at` string, date-time, nullable: Time when project was created
  - `status` string, nullable: Status of project
  - `properties` object, nullable: Properties of project

## Other responses

- `400`: Bad Request
- `401`: Authorization error
- `403`: Request forbidden -- authorization will not help

## Changes

- **2026-10-19** `4b2c943a00dc`: 1 info
  - the `color` request property default value changed from `#EB661E` to `#02786D`
- **2026-10-19** `94a4ab95a805`: 1 info
  - the `color` request property default value changed from `#6C757C` to `#EB661E`

[Operation history](https://skmtc.dev/mammoth/apis/mammoth-analytics/changes/workspaces/:workspace_id/projects/post.md)

---

[API](https://skmtc.dev/mammoth/apis/mammoth-analytics.md) · [All operations](https://skmtc.dev/mammoth/apis/mammoth-analytics/llms.txt) · [OpenAPI document](https://skmtc.dev/mammoth/apis/mammoth-analytics/revisions/5dfd1c296ded?raw)