Function name
create-projects
Parameters
- data (Required). It is an array of project fields. The details of the fields are as follows:
project_category_id (Required). ID or Name of the project category.
summary (Required). A short description of the project.
plan_start (Required). Date. The planned start date of this project.
deadline (Required). Date. The planned finish date of this project.
manager_id (Required). ID or Name of the project manager.
client_id (Required). ID or Name of the client.
code (Optional). A unique code for the project.
priority (Optional). Integer between 1 (Very High) and 5 (Very Low)
detail (Optional). A detailed description for this project.
phase_id (Optional). The ID or Name of the project phase.
budget (Optional). Number. The budget for this project.
workspace_id (Required). ID or Name of the project's department.
billing_model (Optional). Integer. 1 for Fixed and 2 for Hourly.
fixed_price(Optional). Integer. The amount if your billing model is fixed price.
custom_field_1 (Optional). The custom field attached to a project. You need to use the Formula Key of the custom field.
Return Values
project_id(s)
When your data format is XML, you should post something like this:
<data>
<item> <!--create projects-->
<code>PRJ-101</code>
<project_category_id>Animation</project_category_id>
<manager_id>Mary Jane</manager_id>
<client_id>Acme Consulting</client_id>
<phase_id>In Planning</phase_id>
<workspace_id>Technical</workspace_id>
<summary>Project #1</summary>
<priority>2</priority>
<plan_start>2010-11-02T08:00:00</plan_start>
<deadline>2010-11-04T17:00:00</deadline>
<Start_up_cost>500</Start_up_cost> <!--Start_up_cost is the formula key of a custom field attached to a project>
<budget>100000</budget>
</item>
<item>
<code>PRJ-102</code>
<project_category_id>100</project_category_id>
<manager_id>101</manager_id>
<client_id>201</client_id>
<phase_id>2</phase_id>
<workspace_id>3</workspace_id>
<summary>Project #2</summary>
<priority>1</priority>
<plan_start>2010-11-02T08:00:00</plan_start>
<deadline>2010-11-04T17:00:00</deadline>
<budget>200000</budget>
</item>
</data>
In case of JSON, you should submit an array of objects with the same properties.
[
{
"project_category_id" : "Animation",
"manager_id" : "Mary Jane",
"client_id" : "Acme Consulting",
"phase_id" : "In Planning",
"workspace_id" : "Technical",
"summary" : "Project #1",
"priority" : "2",
"plan_start" : "2010-11-02T08:00:00",
"deadline" : "2010-11-04T17:00:00",
"Start_up_plan: : "500",
"budget" : "100000",
}
{
"project_category_id" : "101",
...
}
]