---
title: "Create a New User Award"
method: POST
path: "/api/v2/awards"
tags: ["Awards"]
---

# Create a New User Award

`POST /api/v2/awards`

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

## Request body

- V2AwardsBody
  - `data` Apiv2awardsData
    - `type` string — The type of resource being created.
    - `attributes` Apiv2awardsDataAttributes
      - `user-id` string, required — The email address of the user associated with the award.
      - `user-identifier-type` string, required — Can be any of `UserId`, `Email`, `EmployeeId`, `AliasUid`, or `AliasEmail`.
      - `title` string, required — The title of the award. A maximum of 255 characters is allowed.
      - `awarded-at` string, date-time, required — The date and time when the award was given.
      - `image-url` string — The URL or path to an image representing the award. A maximum of 2000 characters is allowed.
      - `url` string, uri — A URL to a page with more information about the award. A maximum of 2000 characters is allowed.
      - `issued-by` string, required — The organization or person who issued the award. A maximum of 2000 characters is allowed.

## Response `201`

Success

- InlineResponse20112
  - `data` InlineResponse20112Data
    - `type` string — The type of resource.
    - `id` string — Unique identifier for the award.
    - `attributes` InlineResponse20112DataAttributes
      - `external-id` string, nullable — An external identifier for the award, if applicable.
      - `user-identifier-type` string — Can be any of `UserId`, `Email`, `EmployeeId`, `AliasUid`, or `AliasEmail`.
      - `user-id` string — The email address of the user associated with the award.
      - `title` string — The title of the award.
      - `awarded-at` string, date-time — The date and time when the award was given.
      - `image-url` string — The path or URL to an image representing the award.
      - `url` string, uri — A URL with more details about the award.
      - `issued-by` string — The organization or individual that issued the award.
    - `links` InlineResponse20112DataLinks
      - `self` string, uri — The URL to the specific award 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/revisions/4a22b709515c/schema)