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

# Create a Skill Suggestion

`POST /api/v2/skill-suggestions`

This endpoint creates a skill suggestion. Your organization must have Skills+ enabled to use this endpoint.<h3>Required Scope</h3>`skill_suggestions:write`

## Request body

- V2SkillsuggestionsBody
  - `data` Apiv2skillsuggestionsData, required
    - `type` string, required — The resource type. Can only be skill-suggestions.
    - `attributes` Apiv2skillsuggestionsDataAttributes, required
      - `provider-code` string, required — External content/provider code.
      - `skill-names` string[], required — One or more skill names to suggest.
      - `user-id` string, required — Identifier value for the user (matches the identifier type).
      - `user-identifier-type` string, required — The type of user identifier provided (e.g., Email, UserId).

## Response `201`

Created

- InlineResponse20022
  - `data` InlineResponse20022Data[], required
    - `type` string, required — The resource type.
    - `id` integer, required — Server-generated identifier for the suggestion.
    - `attributes` InlineResponse20022Attributes, required
      - `provider-code` string
      - `skill-names` string[]
      - `user-id` string
    - `links` InlineResponse20022Links
      - `self` string — Resource URL.

---

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