# Create Project

**POST /api/v1.0/projects**

Creates a new project. Send the body as **multipart/form-data** (form-data). Optional file field: `logo` (project image).


## Servers
- https://openapi.niftypm.com: https://openapi.niftypm.com ()



## Parameters



### Body: multipart/form-data (object)

- **subteam_id** (string)
  Subteam ID to create the project under. Omit to create in the default team context.

- **name** (string)
  Project name. Required.

- **description** (string)
  Project description or summary.

- **demo** (string)
  Whether this is a demo project. Send as form field "true" or "false".

- **template_id** (string)
  Template ID to create the project from. Omit to create a blank project.

- **nice_id** (string)
  Short custom identifier for the project (2–3 characters). Used in task IDs and URLs.

- **access_type** (number)
  Who can access the project. Values: public (0), limited (1), personal (2). Send as form string (e.g. "0").

- **project_type** (number)
  Project type. Values: default (0), demo (1), empty (2). Send as form string (e.g. "0").

- **default_tasks_view** (string)
  Default view for the Tasks section. Allowed: table, calendar, swimlane, kanban, timeline, report.

- **disabled** (array[string])
  List of feature names to disable on the project. Omit or leave empty if none.

- **disabled_widget** (array[string])
  Widgets to hide on the project. Allowed values: milestones, tasks, discussion, docs, files, time, description, members, activity. Send multiple form fields or comma-separated.



## Responses
### 201
The resource created successfully

#### Body: application/json (object)
- **id** (string)
  Project ID (shortid format, e.g. from shortid package).

- **nice_id** (string)
  Short custom identifier for the project (2–5 characters). Used in task IDs and URLs.

- **name** (string)
  Project name.

- **description** (string)
  Project description or summary.

- **initials** (string)
  Project initials (abbreviation).

- **logo** (string)
  URL of the project logo image. Omitted if not set.

- **color** (string)
  Primary hex color for the project.

- **secondary_color** (string)
  Secondary hex color for the project.

- **demo** (boolean)
  Whether this is a demo project.

- **archived** (boolean)
  Whether the project is archived.

- **auto_milestones** (boolean)
  Whether automatic milestones are enabled.

- **default_tasks_view** (string)
  Default view for the Tasks section: table, calendar, swimlane, kanban, timeline, report.

- **access_type** (string)
  Access type: public, limited, or personal.

- **owner** (string)
  Project owner member ID (shortid).

- **members** (array[string])
  List of project member IDs (shortid), excluding owner.

- **general_discussion** (string)
  General discussion thread ID (shortid).

- **subteam** (string)
  Subteam ID (shortid) this project belongs to.

- **progress** (number)
  Task completion progress (0–1). Completed tasks / total tasks.

- **joined** (boolean)
  Whether the requesting member has joined the project.

- **general_discussion_muted** (boolean)
  Whether general discussion is muted for the requesting member.

- **email** (string)
  Project-specific email address for sending to discussion.

- **zoom_id** (string)
  Zoom meeting ID when Zoom is linked.

- **zoom_password** (string)
  Zoom meeting password when Zoom is linked.

- **zoom_join_url** (string)
  Zoom join URL when Zoom is linked.

- **webex_id** (string)
  Webex meeting ID when Webex is linked.

- **webex_password** (string)
  Webex meeting password when Webex is linked.

- **webex_join_url** (string)
  Webex join URL when Webex is linked.

- **enabled_modules** (array[string])
  Enabled project modules (e.g. milestones, tasks, docs).

- **disabled_modules** (array[string])
  Disabled project modules.

- **disabled_widgets** (number)
  Widgets disabled on the project. See WidgetsType enum.

- **hidden_taskboard_fields** (number)
  Task board fields hidden from view. See TaskBoardFieldType enum.

- **repo** (string | null)
  Linked GitHub repo URL. Null if not linked.

- **total_story_points** (number)
  Total story points across all tasks.

- **completed_story_points** (number)
  Completed story points.

- **pinned_message** (string)
  Pinned message content in general discussion.

- **pinned_by** (string)
  Member ID (shortid) who pinned the message.

- **completion_groups** (array[string])
  Completion groups for task grouping.

- **doc_root_folder** (object)
  Root folder reference for Documents section.

- **file_root_folder** (object)
  Root folder reference for Files section.

- **removed** (boolean)
  True if the project is scheduled for deletion (soft-deleted).

- **milestones_rollup** (object)
  Rollup summary for milestones.

- **rollups** (array[object])
  Rollup summaries for various entities.

- **list_columns_order** (array[string])
  Order of list view columns.

- **hidden_list_columns** (array[string])
  List view columns hidden from display.

- **integrations** (array[object])
  Integrations connected to the project (e.g. Slack, GitHub).


### 401
The client request has not been completed because it lacks valid authentication credentials for the requested resource.

### 403
The client does not have access rights to the content.

### 405
The request method is known by the server but is not supported by the target resource. 


[Powered by Bump.sh](https://bump.sh)