---
title: "Create a Skill Category"
method: POST
path: "/api/v2/skill-categories"
tags: ["Skills+"]
---

# Create a Skill Category

`POST /api/v2/skill-categories`

This endpoint creates a new skill category in Skills+. Categories may align to job roles, skill sets, or be defined by company/industry best practices. <h3>Required Scope</h3>`skill:write`

## Request body

- V2SkillcategoriesBody
  - `data` Apiv2skillcategoriesData, required
    - `type` 'skill-categories', required — Resource type (must be "skill-categories").
    - `attributes` Apiv2skillcategoriesDataAttributes, required
      - `name` string, required — The name of the skill category.
      - `description` string — A description of the skill category.

## Response `200`

Success

- InlineResponse20034
  - `data` InlineResponse20034Data
    - `type` 'skill-categories' — Resource type
    - `id` string — The category id.
    - `attributes` InlineResponse20034DataAttributes
      - `category-id` string — The category id.
      - `name` string — The name of the category.
      - `description` string, nullable — The description of the category.
      - `created-at` string, date-time — Creation timestamp.
      - `updated-at` string, date-time, nullable — Last update timestamp.
      - `skills` object[], nullable — List of associated skills.
    - `links` InlineResponse20033Links
      - `self` string, uri, required

---

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