---
title: "Create A Skill"
method: POST
path: "/api/v2/skills-plus-skills"
tags: ["Skills+"]
---

# Create A Skill

`POST /api/v2/skills-plus-skills`

This endpoint creates a skill in Skills+ for your organization. <h3>Required Scope</h3>`skill:write`

## Request body

- V2SkillsplusskillsBody
  - `data` Apiv2skillsplusskillsData
    - `type` string
    - `attributes` Apiv2skillsplusskillsDataAttributes
      - `skill-name` string, required — The name of the skill.
      - `source-id` string, required — The ID of the skill source in Skills+.
      - `description` string — The description of the skill.
      - `external-id` string — The external ID of the skill.
      - `is-proprietary` boolean — Indicates whether the skill is proprietary to your organization.
      - `is-endorsed` boolean — Indicates whether this skill is endorsed. Endorsed Skills indicate that a learning professional in your organization reviewed and validated it.
      - `skill-review-access` string — Indicates if the skill is enabled for Skill Review and if the Skill Review-enabled skill is visible to everyone in the organization, or only visible to specific Groups. 'None' indicates Skill Review has not been enabled for this skill. 'Org' indicates the Skill Review-enabled skill is visible to everyone in the organization.
      - `skill-review-groups` string — The skill review group this skill is visible to.

## Response `201`

Success

- InlineResponse20115
  - `data` InlineResponse20115Data
    - `type` string
    - `id` string
    - `attributes` InlineResponse20115DataAttributes
      - `synonyms` string[]
      - `skill-review-groups` string[]
      - `description` string — The description of the skill.
      - `external-id` string — The external ID of the skill.
      - `is-proprietary` boolean, nullable — Indicates whether the skill is proprietary to your organization.
      - `is-endorsed` boolean — Indicates whether this skill is endorsed. Endorsed Skills indicate that a learning professional in your organization reviewed and validated it.
      - `skill-review-access` string — Indicates if the skill is enabled for Skill Review and if the Skill Review-enabled skill is visible to everyone in the organization, or only visible to specific Groups. 'None' indicates Skill Review has not been enabled for this skill. 'Org' indicates the Skill Review-enabled skill is visible to everyone in the organization.
      - `skill-name` string — The name of the skill.
      - `source-id` string — The ID of the source the skill belongs to.
      - `locale` string — The language code of the skill.
      - `is-archived` boolean — Indicates whether the skill is archived.
    - `links` InlineResponse20030Links1
      - `self` string, uri

---

[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)