---
title: "Create a New Skill Rating"
method: POST
path: "/api/v2/skill-ratings"
tags: ["SkillRating"]
---

# Create a New Skill Rating

`POST /api/v2/skill-ratings`

This endpoint creates a new skill rating for a user. <h3>Required Scope</h3>`skill_ratings:write`

## Request body

- V2SkillratingsBody
  - `data` Apiv2skillratingsData
    - `type` string
    - `attributes` Apiv2skillratingsDataAttributes
      - `user-id` string, nullable, required — The ID of the user being rated.
      - `user-identifier-type` string, nullable — The type of `user-id` supplied. Can be any of `UserId`, `Email`, `EmployeeId`, `AliasUid`, or `AliasEmail`
      - `skill-id` string, nullable — The ID of the skill.
      - `skill-name` string, nullable, required — The name of the skill.
      - `rating` integer, required — Rating of the skill. An integer value from 0 up to and including 8, unless your organization uses a scale of 1 to 6.
      - `rating-label` string, nullable — The external rating label. When `rating-type` is `manager`, `self`, or `peer`, the `rating` attribute must be provided, and `rating-label` should be `null`.
      - `rating-type` string, nullable, required — The type of rating. Can be `self`, `peer`, or `manager` or a valid provider code of an external rating provider. When the rating-type is `self`, `peer`, or `manager`, the `rating` attribute must be provided and the `rating-label` attribute should be `null`. When `rating-type` is the provider code of an external rating provider, then the `rating-label` attribute must be used, and the `rating` attribute should be 0.
      - `manager-id` string, nullable — The ID of the manager who is providing a rating.
      - `rater-id` string, nullable — The ID of the rater (either Peer or Manager) who is providing a rating.
      - `comment` string — A comment for the rating.
      - `skill-scale` string — Required if a custom skill scale is enabled in Degreed Skills. Must be the highest rating option for your default skill scale.

## Response `201`

Success

- PostedSkillRating
  - `data` PostedSkillRatingData
    - `type` string, nullable
    - `id` string, nullable
    - `attributes` PostedSkillRatingDataAttributes
      - `user-id` string, nullable — The ID of the user being rated.
      - `manager-id` string, nullable — The ID of the manager who is providing a rating.
      - `rater-id` string, nullable — The ID of the manager or peer who is providing a rating.
      - `skill-id` string, nullable — Unique identifier of the skill.
      - `skill-name` string, nullable — The name of the skill.
      - `comment` string, nullable — A comment for the rating.
      - `rating-type` string, nullable — The type of rating. Can be `self`, `peer`, or `manager`, or a valid provider code of an external rating provider.
      - `rating-label` string — The external rating label provided or the accompanying name associated with the rating value on the default internal skill scale.
      - `rating` integer — Rating of the skill. An integer value from 0 up to and including 8, unless your organization uses a scale of 1 to 6.
      - `rated-at` string, date-time — Date the skill was rated. (UTC)
      - `skill-scale` string, nullable — If a custom skill scale is enabled, can only be `Six` or `Eight`.
    - `links` SelfLink
      - `self` string

---

[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/revisions/4a22b709515c/schema)