FAfactorialhr
Finance > CostCenter

Creates a Cost center

Changed on

Creates a Cost center

post/api/2026-10-01/resources/finance/cost_centers

Request

  • Base URL
    https://api.factorialhr.com
  • URL
    https://api.factorialhr.com/api/2026-10-01/resources/finance/cost_centers
  • Auth
    • OAuth 2
      Authorization code: https://id.factorialhr.com/oauth/authorize
      Token URL: https://id.factorialhr.com/api/oauth/token scopes: finance
    • or API key in header x-api-key

Request body

namestring required

Name of the cost center.

company_idstring required

Company id the cost center belongs to.

legal_entity_idstring

Legal entity id the cost center belongs to.

codestring

Optional unique code of the cost center.

descriptionstring

Optional free text describing the cost center.

Example request

{
  "name": "Marketing",
  "company_id": "1",
  "legal_entity_id": "125",
  "code": "CC-001",
  "description": "Cost center for the marketing department"
}

Response

CREATED

idstring required

Factorial id of the cost center.

namestring required

Name of the cost center.

company_idstring required

Company id the cost center belongs to.

legal_entity_idstring

Legal entity id the cost center belongs to.

codestring

Optional unique code of the cost center.

descriptionstring

Optional free text describing the cost center.

active_employees_countinteger required

Number of employees currently assigned to the cost center.

historical_employees_countinteger required

Number of employees ever assigned to the cost center.

statusstring required

Whether the cost center is active or inactive.

deactivation_datestring

Date the cost center was deactivated, if inactive.

Example response

{
  "id": "1",
  "name": "Marketing",
  "company_id": "1",
  "legal_entity_id": "125",
  "code": "CC-001",
  "description": "Cost center for the marketing department",
  "status": "active"
}

Changes