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

# Create project

`POST /projects`

## Request body

- object
  - `project_name` string, required
  - `user_email` string
  - `user_id` integer
  - `metadata` object
  - `contact_id` integer
  - `idempotency_key` string — Optional idempotency key - this must be unique across firm's projects

## Response `200`

successful

- object
  - `data` object
    - `id` integer
    - `name` string
    - `idempotency_key` string
    - `metadata` object
    - `assignees` Assignee[]
      - `id` integer
      - `email` string
    - `tasks` Task[]
      - `id` integer
      - `name` string — Name of the task
      - `description` string — Description of the task - supports limited subset of HTML <b>, <ul>, <li>, <br>, and <a>.
      - `status` 'to_do' | 'pending_review' | 'approved' — Status of the task
    - `user` User
      - `id` integer
      - `email` string
    - `tags` Tag[]
      - `id` integer
      - `name` string

## Other responses

- `400` — project with idempotency key already exists

---

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