Skip to main content
POST
/
hris
/
skills
Create skill
curl --request POST \
  --url https://api.kombo.dev/v1/hris/skills \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Integration-Id: <x-integration-id>' \
  --data '{
  "name": "TypeScript Programming"
}'
{
  "status": "success",
  "data": {
    "id": "28KMdr68N8kG9EzLwjsN9aoz",
    "remote_id": "238476582",
    "name": "TypeScript Programming",
    "description": "The ability understand and write TypeScript code.",
    "orderedLevels": [
      "Proficiency Level 1",
      "Proficiency Level 2",
      "Proficiency Level 3",
      "Proficiency Level 4",
      "Proficiency Level 5"
    ],
    "changed_at": "2022-08-07T14:01:29.196Z",
    "remote_deleted_at": null,
    "remote_data": null
  }
}
Closed Beta Feature: This endpoint is currently in closed beta. We’re testing it with selected customers before its public release. If you’re interested in learning more or getting early access, please reach out.
Create a new skill in the HRIS system with specified name and levels. Refer to our coverage grid for support of levels.

Authorizations

​
Authorization
string
header
required

Create an API key on the Secrets page in the Kombo dashboard.

Headers

​
X-Integration-Id
string
required

ID of the integration you want to interact with.

Body

application/json

POST /hris/skills Request body

​
name
string
required

The name of the skill

​
levels
string[]

List of available skill levels (e.g., ["Beginner", "Intermediate", "Advanced"])

Response

POST /hris/skills Positive response

​
status
string
required
Allowed value: "success"
​
data
object
required
Examples:
{
  "id": "28KMdr68N8kG9EzLwjsN9aoz",
  "remote_id": "238476582",
  "name": "TypeScript Programming",
  "description": "The ability understand and write TypeScript code.",
  "orderedLevels": [
    "Proficiency Level 1",
    "Proficiency Level 2",
    "Proficiency Level 3",
    "Proficiency Level 4",
    "Proficiency Level 5"
  ],
  "changed_at": "2022-08-07T14:01:29.196Z",
  "remote_deleted_at": null,
  "remote_data": null
}