---
title: "Create a New User Skill"
method: POST
path: "/api/v2/user-skills"
tags: ["UserSkill"]
---

# Create a New User Skill

`POST /api/v2/user-skills`

This endpoint creates a new relationship between a user and a skill. If the skill doesn't exist yet, the system creates it. To identify the user you can either supply the `UserId`, `Email` or `EmployeeId`. <h3>Required Scope</h3>`user_skills:write`

## Request body

- V2UserskillsBody
  - `data` Apiv2userskillsData
    - `type` string
    - `id` string
    - `attributes` Apiv2userskillsDataAttributes
      - `user-id` string, nullable, required — The unique ID of the user.
      - `user-identifier-type` string, nullable, required — Can be any of `UserId`, `Email`, or `EmployeeId`.
      - `skill-name` string, nullable, required — The name of the skill to be assigned to the user.
      - `is-focus` boolean — Indicates whether the skill is a focus skill. There are only four focus skills allowed per user.

## Response `201`

Success

- PostedUserSkill
  - `data` PostedUserSkillData
    - `type` string, nullable
    - `id` string, nullable
    - `attributes` PostedUserSkillDataAttributes
      - `user-id` string, nullable — The unique user identifier.
      - `user-identifier-type` string, nullable — Can be any of `UserId`, `Email`, or `EmployeeId`.
      - `skill-name` string, nullable — The name of the skill to be assigned to the user.
      - `is-focus` boolean — Indicates whether this is a focus skill for the user.
      - `target-rating` integer — The target rating for the user skill.

---

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