Create Project — Project Manager

Create a new project based on the details provided.

A Project is a collection of Tasks that contributes towards a goal. Within a Project, Tasks represent individual items of work that team members must complete. The sum total of Tasks within a Project represents the work to be completed for that Project.

Headers

x-integration-namestringOptional

The name of the calling system passed along as a header parameter

Request

This endpoint expects an object.

namestringOptional

The name of the Project.

descriptionstringOptional

An optional description of the Project

folderIdstringOptional

The unique identifier of the folder of this project, or null if not assigned.

projectAccessobjectOptional

If you wish to grant access to this Project to a selected list of people during creation, provide a list of ProjectMembers here. If you do not specify anyone, this Project will be available to only yourself.

customerIdstringOptional

The unique identifier of the customer for this project, or null if not customer specific

managerIdstringOptional

The unique identifier of the manager of this project, or null if not assigned.

chargeCodeIdstringOptional

The unique identifier of the ChargeCode for this Project, if one has been selected.

statusIdstringOptional

The ProjectStatus chosen for this Project, if one has been selected.

priorityIdstringOptional

The ProjectPriority level of this Project, if one has been selected.

hourlyRatedoubleOptional

The default hourly rate for work on this Project. This rate will be used if an assignee working on this Project does not have an hourly rate configured in their profile.

budgetdoubleOptional

The proposed budget for this Project.

statusUpdatestringOptional

Contains an optional status update for Projects that can be used to summarize the status of multiple Projects at a glance.

You can edit the StatusUpdate field on the Portfolio page of the application.

templatebooleanOptional

True if this Project is a template that will be reused as a framework for future Projects.

You can save a Project as a template and reuse it in the future for creating additional Projects. If this Project is a template, set this to true and this template will be available to choose from when creating a new Project within the application.

templateIdstringOptional

When creating a Project, you can optionally specify a Template to use to construct the Project using a collection of pre-designed Tasks.

Specifying a value in the TemplateId field will copy default settings for Tasks from your template Project into the newly created Project.

This field does not support custom templates. You must choose from a list of ProjectManager-supplied templates.

targetDatestringOptional

The target planned completion date for this Project, or null if one has not been selected. This value can be updated in the Project Settings page or the Portfolio Project page within the application.

favoritebooleanOptional

True if this Project is marked as favorite for current user

taskStatusCreatelist of objectsOptional

Create default task status upfront

Response

Success

errorobjectOptional

If the API call failed, this will contain information about the error that occurred.

successbooleanOptional

True if the API call succeeded; false otherwise.

hasErrorbooleanOptional

True if the API call failed.

statusCodeenumOptional

The HTTP code of the response.

dataobjectOptional

1	curl -X POST https://api.projectmanager.com/api/data/projects \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{}'

1	{
2	"error": {
3	"technicalError": "technicalError",
4	"additionalErrors": [
5	"additionalErrors"
6	],
7	"validationErrors": {
8	"key": [
9	"value"
10	]
11	},
12	"message": "message"
13	},
14	"success": true,
15	"hasError": true,
16	"statusCode": "Continue",
17	"data": {
18	"id": "id",
19	"name": "name",
20	"description": "description",
21	"shortCode": "shortCode",
22	"shortId": "shortId",
23	"folder": {
24	"id": "id",
25	"name": "name"
26	},
27	"status": {
28	"id": "id",
29	"name": "name",
30	"isDeleted": true
31	},
32	"startDate": "startDate",
33	"endDate": "endDate",
34	"targetDate": "targetDate",
35	"plannedStartDate": "plannedStartDate",
36	"plannedFinishDate": "plannedFinishDate",
37	"actualStartDate": "actualStartDate",
38	"actualFinishDate": "actualFinishDate",
39	"priority": {
40	"id": "id",
41	"name": "name"
42	},
43	"chargeCode": {
44	"id": "id",
45	"name": "name"
46	},
47	"manager": {
48	"id": "id",
49	"name": "name",
50	"initials": "initials",
51	"avatarUrl": "avatarUrl"
52	},
53	"customer": {
54	"id": "id",
55	"name": "name"
56	},
57	"budget": 1.1,
58	"hourlyRate": 1.1,
59	"statusUpdate": "statusUpdate",
60	"modifyDate": "2024-01-15T09:30:00Z",
61	"createDate": "2024-01-15T09:30:00Z",
62	"isTemplate": true,
63	"favorite": true,
64	"creationTemplateId": "creationTemplateId",
65	"members": [
66	{}
67	],
68	"fieldValues": [
69	{}
70	],
71	"files": [
72	{}
73	],
74	"percentComplete": 1,
75	"fields": {
76	"key": "value"
77	}
78	}
79	}