Create cost center

post

https://api.perk.com/cost_centers

Creates a cost center with the specified name. You can optionally set an approver, delegate, delegate expiry date, additional approvers (owner_ids), and cost object type (type) when that feature is enabled for your organization.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

name

string

required

The name of the cost center

type

string | null

Available only when cost object types are enabled for your organization on request, is ignored when the feature is not enabled. Cost object type name to assign on create. Non-empty string (max 256 characters). Omit or null leaves the type unset. If a type with that name already exists (case-insensitive), it is assigned; otherwise it is created. Cannot be set on Yokoy-sourced cost centers.

approver_id

integer

The ID of the user to set as approver. The user must belong to one of the account's companies

delegate_id

integer

The ID of the user to set as delegate. The delegate must belong to one of the account's companies

delegate_expiry

string

The expiry date for the delegate in YYYY-MM-DD format

erp_code

string

Identifier used to associate this cost center with a corresponding record in an external ERP system

company_ids

array of integers

IDs of companies this cost center is scoped to. Must be provided together with 'all_companies'. When 'all_companies' is true, company scope is set to all companies in the account.

company_ids

all_companies

boolean

Whether the cost center applies to all companies in the account. Must be provided together with 'company_ids'. When true, 'company_ids' is ignored and the cost center is scoped to all companies in the account. Defaults to true when neither field is provided.

owner_ids

array of integers

IDs of additional travel approvers to set on create. Users must belong to an allowed company for the cost center and must not duplicate approver_id

owner_ids

Headers

Authorization

string

required

Your Perk API key

Responses

200Returns '200 OK' and the newly created cost center resource.

400Returns '400 Bad Request' when the request body is invalid (for example missing name, invalid owner_ids, blank/overlong type, or setting type on a Yokoy-sourced cost center).