---
title: "Create a key performance indicator"
method: POST
path: "/performance/key_performance_indicators"
tags: ["KPI"]
---

# Create a key performance indicator

`POST /performance/key_performance_indicators`

## Request body

- object
  - `title` string, required
  - `kpi_type` 'individual' | 'department' | 'location' | 'division' | 'company', required
  - `metric` 'percentage' | 'number' | 'currency', required
  - `currency_code` string — Required if `metric` is `currency`
  - `department_id` integer — Required if `kpi_type` is `department`
  - `location_id` integer — Required if `kpi_type` is `location`
  - `division_id` integer — Required if `kpi_type` is `division`
  - `user_id` integer, required — KPI owner
  - `weight` integer

## Response `201`

Created

- object
  - `data` KeyPerformanceIndicator — Location, division, department fields will be present depends on kpi_type
    - `id` integer
    - `title` string
    - `description` string
    - `weight` number, float
    - `currency_code` string
    - `metric` 'percentage' | 'number' | 'currency'
    - `status` 'none' | 'on_track' | 'behind' | 'at_risk'
    - `kpi_type` 'individual' | 'department' | 'location' | 'division' | 'company'
    - `progress_percentage` integer
    - `location` Location — Location model
      - `id` string, required
      - `name` string, required — Name of the location
    - `division` Division
      - `id` integer
      - `name` string
    - `department` Department
      - `id` integer, required
      - `name` string, required
      - `parent_id` integer
      - `manager_id` integer — Employee ID for manager of the department
      - `department_level_id` integer — Department level ID
    - `owner` object
      - `id` integer
      - `first_name` string
      - `last_name` string
      - `email` string
    - `created_at` string
    - `updated_at` string

---

[API](https://skmtc.dev/peopleforce/apis/company-api.md) · [All operations](https://skmtc.dev/peopleforce/apis/company-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/peopleforce/company-api/revisions/ff612e61a4c3/schema)