---
title: "Create a comp band"
method: POST
path: "/v1/org/{orgId}/band"
tags: ["band"]
---

# Create a comp band

`POST /v1/org/{orgId}/band`

## Path parameters

- `orgId` string, required

## Query parameters

- `date` string, date

## Request body

- CreateCompBand
  - `label` string, required — human-readable name of content
  - `color` string, required — hex color associated with the band level
  - `baseCompMax` Money
    - `amount` number, required
    - `currency` string, required
    - `places` integer
  - `baseCompMid` Money
    - `amount` number, required
    - `currency` string, required
    - `places` integer
  - `baseCompMin` Money
    - `amount` number, required
    - `currency` string, required
    - `places` integer
  - `baseSpread` number — spread percent used to calculate base comp from the midpoint
  - `baseInterval` EnumValue, required
    - `name` string, required — enum value name
    - `label` string, required — enum value label
    - `color` string — color of property
    - `expr` string — computed expression, for ENUM_EXPR type
    - `num` number — numeric value, for ENUM_SCALE type
    - `sort` integer — sort order
    - `rank` integer — rank order, if selected in rank order
    - `id` string — unique identifier for enum
    - `labelTr` Translations
      - `values` object, required
  - `baseTargetPay` Money
    - `amount` number, required
    - `currency` string, required
    - `places` integer
  - `baseTargetPayPercentile` number — base target pay associated with open jobs at this band level, as a percentile
  - `equityTargetShares` number — target equity for the band, in shares
  - `equityTargetPercentOfBase` number — target equity for the band, as a percentage of base
  - `equityTargetValue` number — target equity for the band, as a monetary value, in the same currency as the base
  - `equityRefreshShares` number — refresh grant equity for the band, in shares
  - `equityRefreshPercentOfBase` number — refresh grant equity for the band, as a percentage of base
  - `equityRefreshValue` number — refresh grant equity for the band, as a monetary value, in the same currency as the base
  - `variableValue` Money
    - `amount` number, required
    - `currency` string, required
    - `places` integer
  - `variablePercentOfBase` number — variable compensation for the band, specified as a percentage of base
  - `startingSalary` Money
    - `amount` number, required
    - `currency` string, required
    - `places` integer
  - `jobTierOneField` JobTierField
    - `code` string
    - `value` string, required
  - `jobTierTwoField` JobTierField
    - `code` string
    - `value` string, required
  - `jobTierThreeField` JobTierField
    - `code` string
    - `value` string, required
  - `jobLevel` string, required — job level associated with the comp band

## Response `202`

snapshot currently building

## Other responses

- `400` — bad request
- `401` — not authorized
- `404` — not found

---

[API](https://skmtc.net/charthop/apis/charthop-api.md) · [All operations](https://skmtc.net/charthop/apis/charthop-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/charthop/charthop-api/versions/50a1edd6b27e/schema)