---
title: "Create a New User Degree"
method: POST
path: "/api/v2/degrees"
tags: ["Degrees"]
---

# Create a New User Degree

`POST /api/v2/degrees`

This endpoint creates a new degree for the specified user. <h3>Required Scope</h3>`degrees:write`

## Request body

- V2DegreesBody
  - `data` Apiv2degreesData, required
    - `type` string — The type of resource being created.
    - `attributes` Apiv2degreesDataAttributes
      - `user-id` string, required — The user's identifier (e.g., email or ID).
      - `user-identifier-type` string, required — The type of user identifier provided (e.g., Email, ID).
      - `title` string, required — The title of the degree. A maximum of 255 characters is allowed.
      - `graduated-at` string, date-time, required — The graduation date.
      - `image-url` string — The path or URL to an image representing the degree. A maximum of 2000 characters is allowed.
      - `url` string, uri — A URL with additional details about the degree or award. A maximum of 2000 characters is allowed.
      - `college` string, required — The name of the college where the degree was obtained.

## Response `201`

Success

- InlineResponse20110
  - `data` InlineResponse20110Data
    - `type` string — The type of resource.
    - `id` string — Unique identifier for the degree.
    - `attributes` InlineResponse20110DataAttributes
      - `external-id` string, nullable — An external identifier for the degree, if applicable.
      - `user-identifier-type` string — Can be any of `UserId`, `Email`, `EmployeeId`, `AliasUid`, or `AliasEmail`.
      - `user-id` string — The user's identifier (e.g., email or ID).
      - `title` string — The title of the degree.
      - `graduated-at` string, date-time — The graduation date.
      - `image-url` string — The path or URL to an image representing the degree.
      - `url` string, uri — A URL with additional details about the degree or award.
      - `college` string — The name of the college where the degree was obtained.
      - `degree` string, nullable — The type of degree. Can be any of PartialAssociates, Associates, PartialBachelors, Bachelors, PartialMasters, Masters, PartialDoctorate, Doctorate, PreDiploma, Diploma, Magister
      - `grade-point-average` number, float, nullable — The GPA associated with the degree.
      - `country` string, nullable — The country where the degree was earned, if applicable.
      - `outside-us` boolean, nullable — Indicates whether the degree was earned outside the United States.
    - `links` InlineResponse20110DataLinks
      - `self` string, uri — The URL to the specific degree resource.

---

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