Create a project.

post

https://api.personio.de/v2/projects

Create a project and return the newly created project ID.

Body Params

Request object for creating a new project.

name

string

required

length ≤ 255

Name of the project.

status

string

enum

required

Status of the project.

Allowed:

project_code

string | null

Optional project code. This field needs to be unique across all projects (regardless of top level or sub project). It can be used as a reference to the projects in another system.

description

string

length ≤ 1000

Optional project description.

cost_center

object | null

Optional cost center ID pointing to an existing Personio cost center ID. Sub projects (projects with a parent project) can't have a cost center.

assigned_to_all

boolean | null

Flag to assign the project to all employees. Projects assigned to all employees can't have members. If set to true, every employee in the company is able to track time against this project. If set to false, only members of the project can track time against this project. If not provided, the default value is false. Sub projects (projects with a parent project) always have the same assigment as their parent project. This field shouldn't be provided for sub projects.

parent_project

object | null

Optional parent project reference by Personio project ID. Sub projects can't be the parent of another sub project (at most one level of nesting).

start

object | null

An optional start date of the project (inclusive).

end

object | null

An optional end date of the project (exclusive).

billable

boolean | null

Flag to mark project as billable. If not provided, the default value is false. Sub projects (projects with a parent project) always have the same billable flag as their parent project. This field shouldn't be provided for sub projects.

client_name

string | null

Optional client name for the project. Sub projects (projects with a parent project) can't have a client name.

project_type

string | null

Optional project type. This is a free text field defined by the customer. Sub projects (projects with a parent project) can't have a project type.

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

201Successful response.

400Invalid request.

403Forbidden

422Unprocessable content.