---
title: "Create a New User Badge"
method: POST
path: "/api/v2/user-badges"
tags: ["Badges"]
---

# Create a New User Badge

`POST /api/v2/user-badges`

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

## Request body

- V2BadgesBody
  - `data` Apiv2badgesData
    - `type` string, nullable
    - `attributes` Apiv2badgesDataAttributes
      - `user-identifier-type` string, required — Can be any of `UserId`, `Email`, `EmployeeId`, `AliasUid`, or `AliasEmail`.
      - `user-id` string, required — The unique ID of the user the badge was issued to.
      - `title` string, required — The title of the badge.
      - `url` string, required — The URL of the badge.
      - `image-url` string, required — The URL of the badge image to be displayed.
      - `provider` string, required — The badge issuer.
      - `state` string, required — The state of the badge. Can only be `pending` or `accepted`.
      - `issued-at` string, date-time — When the badge was issued.
      - `expires-at` string, date-time — When the badge will expire.
      - `created-at` string, date-time
      - `source` string, required — Who created the badge.
      - `external-id` string, required — The external identifier provided by badge issuer.

## Response `201`

Success

- InlineResponse2013
  - `data` InlineResponse2013Data
    - `type` string, nullable
    - `id` string, nullable — The id of the badge.
    - `attributes` InlineResponse2013DataAttributes
      - `user-identifier-type` string — Can be any of `UserId`, `Email`, `EmployeeId`, `AliasUid`, or `AliasEmail`.
      - `user-id` string — The unique ID of the user the badge was issued to.
      - `title` string — The title of the badge.
      - `url` string — The URL of the user badge.
      - `image-url` string — The URL of the badge image to be displayed.
      - `provider` string — The badge issuer.
      - `state` string — The state of the badge. For example, `pending` or `accepted`.
      - `issued-at` string, date-time — When the badge was issued.
      - `expires-at` string, date-time — When the badge expires.
      - `source` string — Who created the badge.
      - `external-id` string — The external identifier provided by badge issuer.
    - `links` SelfLink
      - `self` string

---

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