{"_id":"554a7f016b448d0d00646b94","category":{"_id":"554a69ba0b54d30d007fe128","project":"5548466bd2c8410d006c2143","pages":["554a69ca156a480d00e2924a","554a69d40b54d30d007fe129","554a6c8258f5650d00ae440d","554a6c8f58f5650d00ae4410","554a6c990b54d30d007fe131","554a7c0e38e3620d00821920","554a7e9d6b448d0d00646b92","554a7ea838e3620d00821929","554a7f016b448d0d00646b94","5575c1dbacd0472d000ac9ba"],"version":"5548466bd2c8410d006c2146","__v":10,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-05-06T19:21:30.961Z","from_sync":false,"order":1,"slug":"projects","title":"Projects"},"editedParams2":true,"user":"55484649b2581a0d00913ff3","version":{"_id":"5548466bd2c8410d006c2146","project":"5548466bd2c8410d006c2143","__v":8,"createdAt":"2015-05-05T04:26:19.796Z","releaseDate":"2015-05-05T04:26:19.796Z","categories":["5548466cd2c8410d006c2147","554a69ba0b54d30d007fe128","554a7f3338e3620d0082192e","5565162e03b6710d00916942","55651a0c65a1130d00400c2b","55651d4565a1130d00400c2f","55651e0165a1130d00400c32","5565217903b6710d0091695f"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"editedParams":true,"parentDoc":null,"project":"5548466bd2c8410d006c2143","__v":6,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-05-06T20:52:17.055Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[{"name":"","code":"{ \n    status: \"Okay\",\n    project:  {\n        id:78888,\n        name: 'Rennovation at 42 Wallaby Way',\n        shortName: 'Wallaby',\n        description: 'Major rennovation project for the dentist in Sydney.',\n        budget: 250000,\n        rate: 89.90,\n        chargeCode: {\n            \"id\": 1234\n        },\n        manager: {\n            \"id\": 2345\n        }\n    }\n}","language":"json","status":200}]},"settings":"","examples":{"codes":[{"language":"javascript","code":"$.ajax({\n      url: 'https://api.projectmanager.com/api/v1/projects.json',\n      type: 'post',\n      headers: {\n            apiKey: '[apiKey]',\n      },\n      dataType: 'json',\n      data: {\n            name: 'Rennovation at 42 Wallaby Way',\n            shortName: 'Wallaby',\n            description: 'Major rennovation project for the dentist in Sydney.',\n            budget: 250000,\n            rate: 89.90,\n            chargeCode: {\n              \"id\": 1234\n            },\n            manager: {\n              \"id\": 2345\n            },\n      },\n  success: function (data) {\n\t\t\tconsole.info(data);\n  }\n});","name":"jQuery"}]},"method":"post","auth":"required","params":[{"_id":"554bd10ef2829e1900587225","ref":"","in":"body","required":true,"desc":"The name of the project.","default":"","type":"string","name":"name"},{"_id":"554bd10ef2829e1900587226","ref":"","in":"body","required":false,"desc":"Ths shortname of your project, max 7 characters.","default":"","type":"string","name":"shortName"},{"_id":"554bd10ef2829e1900587228","ref":"","in":"body","required":false,"desc":"The description of the project, max 1000 characters.","default":"","type":"string","name":"description"},{"_id":"554bd10ef2829e1900587227","ref":"","in":"body","required":false,"desc":"Project default rate per hour. Please note that the rate must be non-negative.","default":"0","type":"double","name":"rate"},{"_id":"554bd10ef2829e190058722a","ref":"","in":"body","required":false,"desc":"Budget for project. Please note that the budget must be non-negative.","default":"0","type":"double","name":"budget"},{"_id":"554be9f4374fec0d007e5ff7","ref":"","in":"body","required":false,"desc":"{id: statusId}, can get from /api/v1/ProjectData/statuses","default":"","type":"int","name":"status"},{"_id":"554be9f4374fec0d007e5ff8","ref":"","in":"body","required":false,"desc":"{id: priorityId}, can get from /api/v1/ProjectData/priorities","default":"","type":"int","name":"priority"},{"_id":"554be9f4374fec0d007e5ff9","ref":"","in":"body","required":false,"desc":"{id: managerId}, can get from /api/v1/ProjectData/managers","default":"","type":"int","name":"manager"},{"_id":"554be9f4374fec0d007e5ffa","ref":"","in":"body","required":false,"desc":"{id: custom1Id}, can get from /api/v1/ProjectData/customFields","default":"","type":"int","name":"custom1"},{"_id":"555aae88bdbf120d005a9148","ref":"","in":"body","required":false,"desc":"{id: custom2Id}, can get from /api/v1/ProjectData/customFields","default":"","type":"int","name":"custom2"},{"_id":"555aae88bdbf120d005a9147","ref":"","in":"body","required":false,"desc":"{id: custom3Id}, can get from /api/v1/ProjectData/customFields","default":"","type":"int","name":"custom3"},{"_id":"555aae88bdbf120d005a9146","ref":"","in":"body","required":false,"desc":"{id: custom4Id}, can get from /api/v1/ProjectData/customFields","default":"","type":"int","name":"custom4"},{"_id":"554bd10ef2829e1900587229","ref":"","in":"body","required":false,"desc":"{id: chargeCodeId}, can get from /api/v1/ProjectData/customFields","default":"","type":"int","name":"chargeCode"}],"url":"/projects.json"},"isReference":false,"order":4,"body":"This call will let you create a brand new project for the registered user.\n\nThe parameters `chargeCode`, `customer`, `manager`, `priority` and `status` are specific to the customer's account and need to be referenced by their unique IDs. You can get a list of valid IDs for each of these variables by calling one of the project data endpoints. Eg:  /api/v1/ProjectData/statuses.","excerpt":"A Project resource represents a planned and trackable project within ProjectManager.com.\n\nUse this API to create a single project in Project Manager.com. You can specify a minimum of Project Name to create a Project via the API.","slug":"create-a-project-1","type":"endpoint","title":"Create a Project"}

postCreate a Project

A Project resource represents a planned and trackable project within ProjectManager.com. Use this API to create a single project in Project Manager.com. You can specify a minimum of Project Name to create a Project via the API.

Definition

{{ api_url }}{{ page_api_url }}

Parameters

Body Params

name:
required
string
The name of the project.
shortName:
string
Ths shortname of your project, max 7 characters.
description:
string
The description of the project, max 1000 characters.
rate:
double0
Project default rate per hour. Please note that the rate must be non-negative.
budget:
double0
Budget for project. Please note that the budget must be non-negative.
status:
integer
{id: statusId}, can get from /api/v1/ProjectData/statuses
priority:
integer
{id: priorityId}, can get from /api/v1/ProjectData/priorities
manager:
integer
{id: managerId}, can get from /api/v1/ProjectData/managers
custom1:
integer
{id: custom1Id}, can get from /api/v1/ProjectData/customFields
custom2:
integer
{id: custom2Id}, can get from /api/v1/ProjectData/customFields
custom3:
integer
{id: custom3Id}, can get from /api/v1/ProjectData/customFields
custom4:
integer
{id: custom4Id}, can get from /api/v1/ProjectData/customFields
chargeCode:
integer
{id: chargeCodeId}, can get from /api/v1/ProjectData/customFields

Examples


Result Format


Documentation

This call will let you create a brand new project for the registered user. The parameters `chargeCode`, `customer`, `manager`, `priority` and `status` are specific to the customer's account and need to be referenced by their unique IDs. You can get a list of valid IDs for each of these variables by calling one of the project data endpoints. Eg: /api/v1/ProjectData/statuses.