BObokio
projects

[Preview] Create a project

Changed on

Creates a new project for the company.

A dimension 6 (Project) tag value is created automatically using the projectNumber as its tag. If the company does not yet have a Project tag group, one is created.

The company must have the Tags feature enabled in their price plan.

Preview: This endpoint is in preview and may change or be removed before general availability. Read the full preview policy

Scope: projects:write

post/companies/{companyId}/projects

Request

  • Base URL
    https://api.bokio.se/v1
  • URL
    https://api.bokio.se/v1/companies/{companyId}/projects
  • Auth
    HTTP bearer

Request body

namestring required

Name of the project

projectNumberstring required

The project number, unique per company. Used as the dimension 6 tag value.

startDatestring date nullable

The date the project starts (yyyy-MM-dd)

endDatestring date nullable

The date the project ends (yyyy-MM-dd)

Example request

{
  "name": "Website Redesign",
  "projectNumber": "P-001",
  "startDate": "2026-01-15",
  "endDate": "2026-12-31",
  "customerRef": {
    "id": "d4e5f6a7-b8c9-0123-def1-234567890123",
    "name": "Acme AB",
    "customerNumber": "CUST-001"
  }
}

Response

Project created

idstring uuid required

Unique identifier of the project

namestring required

Name of the project

projectNumberstring required

The project number, unique per company. Used as the dimension 6 tag value.

status'active' | 'archived' required

The lifecycle status of the project

startDatestring date nullable

The date the project starts (yyyy-MM-dd)

endDatestring date nullable

The date the project ends (yyyy-MM-dd)

Example response

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "name": "Website Redesign",
  "projectNumber": "P-001",
  "status": "active",
  "startDate": "2026-01-15",
  "endDate": "2026-12-31",
  "customerRef": {
    "id": "d4e5f6a7-b8c9-0123-def1-234567890123",
    "name": "Acme AB",
    "customerNumber": "CUST-001"
  },
  "tagRef": {
    "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "name": "P-001"
  }
}

Changes