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.

Request

Information about the Project you wish to create

budgetdoubleOptional

The proposed budget for this Project.

chargeCodeIdstringOptionalformat: "uuid"

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

customerIdstringOptionalformat: "uuid"

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

descriptionstringOptional

An optional description of the Project

favoritebooleanOptional

True if this Project is marked as favorite for current user

folderIdstringOptionalformat: "uuid"

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

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.

managerIdstringOptionalformat: "uuid"

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

namestringOptional

The name of the Project.

priorityIdstringOptionalformat: "uuid"

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

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.

statusIdstringOptionalformat: "uuid"

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

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.

targetDatestringOptionalformat: "date"

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.

taskStatusCreatelist of objectsOptional

Create default task status upfront

templateIdstringOptionalformat: "uuid"

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.

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.

statusCodeobjectOptional

The HTTP code of the response.

dataobjectOptional

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

1	{
2	"error": {
3	"additionalErrors": [
4	"foo"
5	],
6	"message": "foo",
7	"technicalError": "foo",
8	"validationErrors": {}
9	},
10	"success": true,
11	"hasError": true,
12	"statusCode": "Continue",
13	"data": {
14	"actualFinishDate": "foo",
15	"actualStartDate": "foo",
16	"budget": 42,
17	"chargeCode": {
18	"id": "foo",
19	"name": "foo"
20	},
21	"createDate": "foo",
22	"creationTemplateId": "foo",
23	"customer": {
24	"id": "foo",
25	"name": "foo"
26	},
27	"description": "foo",
28	"endDate": "foo",
29	"favorite": true,
30	"fieldValues": [
31	{
32	"id": "foo",
33	"shortId": "foo",
34	"name": "foo",
35	"type": "foo",
36	"value": "foo",
37	"createdDate": "foo",
38	"modifiedDate": "foo"
39	}
40	],
41	"files": [
42	{
43	"id": "foo",
44	"name": "foo",
45	"url": "foo",
46	"task": {
47	"id": "foo",
48	"name": "foo",
49	"shortId": "foo"
50	},
51	"folder": {
52	"id": "foo",
53	"name": "foo"
54	}
55	}
56	],
57	"folder": {
58	"id": "foo",
59	"name": "foo"
60	},
61	"hourlyRate": 42,
62	"id": "foo",
63	"isTemplate": true,
64	"manager": {
65	"avatarUrl": "foo",
66	"id": "foo",
67	"initials": "foo",
68	"name": "foo"
69	},
70	"members": [
71	{
72	"id": "foo",
73	"initials": "foo",
74	"name": "foo",
75	"avatarUrl": "foo",
76	"permission": "foo",
77	"color": "foo",
78	"permissionOptions": {
79	"collaborate": true,
80	"editor": true,
81	"guest": true,
82	"manager": true,
83	"none": true
84	},
85	"role": "foo"
86	}
87	],
88	"modifyDate": "foo",
89	"name": "foo",
90	"percentComplete": 42,
91	"plannedFinishDate": "foo",
92	"plannedStartDate": "foo",
93	"priority": {
94	"id": "foo",
95	"name": "foo"
96	},
97	"shortCode": "foo",
98	"shortId": "foo",
99	"startDate": "foo",
100	"status": {
101	"id": "foo",
102	"isDeleted": true,
103	"name": "foo"
104	},
105	"statusUpdate": "foo",
106	"targetDate": "foo",
107	"fields": {}
108	}
109	}

Headers

Request

Response