Create Project (V3)

post

https://{subdomain}.ingenious.build/api/v3/pub/projects

Creates a new project with the provided data and returns its global id. Unlike v2 (POST /api/v2/pub/projects), all normally-required fields (including name and base_currency) are required regardless of status — External Pending projects are no longer exempt.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

name

string

required

Name of the project

status

string | null

enum

Defaults to feasibility

Status of the project, as a kebab-case slug (e.g. "external-pending").

Allowed:

custom_id

string | null

Custom ID of the project

base_currency

string

required

Base Currency of the project. Should be iso3 format

scope

string | null

Scope of the project

scope_exclusions

string | null

Exclusions from the Scope of the project

client_contact_id

string | null

ID of the client contact person

sector

string | null

enum

Sector / Industry of the Project, as a kebab-case slug (e.g. "multi-family" for "Multi-Family"). This list is configurable per workspace under Settings > Sector/Industry; the values below are the defaults.

unit_type

string | null

enum

Allowed:

project_type

string | null

Name of the Project Type. If none found it will be ignored

primary_tag

string | null

Primary tag of the Project

secondary_tag

string | null

Secondary tag of the Project. Can be a string of tags divided by commas

office_location_id

string | null

ID of the office location that has to be attached to the Project. If none found it will be ignored

business_unit_id

string | null

ID of the business unit that has to be attached to the Project. If none found it will be ignored

project_commencement_date

date | null

This is the anticipated or expected project start date. This date is the initial placeholder and can be updated and modified in the Schedule Module

project_completion_date

date | null

This is the anticipated or expected project finish date. This date is the initial placeholder and can be updated and modified in the Schedule Module

project_phase_id

string | null

ID of the project phase that has to be attached to the Project.

client_accounting_company_id

string | null

ID of the client accounting company. Required if Accounting Company selection for Project Creation is enabled

Headers

AccessToken

string

required

Responses

400

Bad Request

401

Unauthorized

422

Request validation error

Language

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

201Created