Skip to content
campaiDeveloper
campai.com

Finance

POST/{organizationId}/finance/costCenters

Update organization cost centers

Updates the organization-wide cost centers inherited by all mandates. It takes an organizationId and a costCenters list and returns no content. A newly added number already defined by a mandate with the same name moves from the mandate to the organization.

Permissions

Send an API key of the organization in the path, using the X-API-Key header.

Who may call it

  • The caller needs organization access with both mandate.edit and costCenter.edit permissions.
  • Access must not be restricted to some mandates.

Request

Path parameters

  • organizationIdidrequired

Body

Content-Type: application/json

  • costCentersobject[]required

    at most 200 items

    3 properties
    • numbernumberrequired

      1–99999999

    • labelstringrequired

      1–64 characters

    • bookablebooleanrequired
Request
curl --fail-with-body --silent --show-error --max-time 30 --globoff \
  --request POST 'https://cloud.campai.com/api/YOUR_ORGANIZATION_ID/finance/costCenters' \
  --header 'X-API-Key: YOUR_API_KEY'

No request that worked has been recorded yet, so the body is not shown.

Response

200 Successful response

No response body is specified.

What else happens

  • On success, the accounting plan's organizationCostCenters are replaced with the supplied list, sorted by number.
  • Newly added organization cost center numbers are removed from mandates that define them.

Errors

Other errors

StatusErrorWhen
400Cost centers are not available for this productIf cost centers are not available for the product, the endpoint returns 400 with key finance.accounting.validateGetCostCenters.notSupportedByProduct. Only region us
400The cost center number(s) numbers already exist with a different name in: mandatesIf a newly added cost center number already exists in a mandate with a different name, the endpoint returns 400 with key routes.finance.updateOrganizationCostCenters.differentLabels. Only region eu
404Accounting plan is missing. Please make sure you have setup your finances app properly.If the accounting plan is missing, the endpoint returns 404 with key finance.accounting.getAccountingPlan.notFound. Only region eu

Marked words such as numbers are filled in with the actual value when the error happens.

Errors nearly every request can meet are listed under Errors.