---
title: "Create a New Certificate"
method: POST
path: "/api/v2/certificates"
tags: ["Certificate"]
---

# Create a New Certificate

`POST /api/v2/certificates`

This endpoint creates a new certificate in the system. <h3>Required Scope</h3>`certificates:write`

## Request body

- V2CertificatesBody
  - `data` Apiv2certificatesData
    - `attributes` Apiv2certificatesDataAttributes
      - `user-id` string, nullable, required — The unique ID of the user who completed it.
      - `title` string, nullable, required — Text describing the certificate. The maximum length is 255 characters.
      - `started-at` string, date-time, nullable, required — Date when the certificate was issued.
      - `completed-at` string, date-time, nullable — Date when the certificate expires.
      - `url` string, nullable — URL of the certificate or issuer.
      - `issued-by` string, nullable, required — Institution that issued the certification.
      - `certificate-number` string, nullable — Certification number from the certifying institution.
      - `user-identifier-type` string, nullable, required — The type of 'user-id' supplied. Can be any of `UserId`, `Email`, `EmployeeId`, `AliasUid`, or `AliasEmail`.
      - `image-url` string — DEPRECATED <br><br>URL of an image which will be shown on the content cards at Degreed.
      - `rating` integer — Rating of the certificate, an integer value from 1 up to and including 8.

## Response `201`

Success

- PostedCertificate
  - `data` PostedCertificateData1
    - `type` string
    - `id` string
    - `attributes` PostedCertificateData1Attributes
      - `user-identifier-type` string, nullable — The type of `user-id` supplied. Can be any of `UserId`, `Email`, `EmployeeId`, `AliasUid`, or `AliasEmail`
      - `user-id` string, nullable — Unique user identifier of the user that completed the certificate.
      - `title` string, nullable — The title of the certificate.
      - `started-at` string, date-time, nullable — Date when the certificate was issued. (UTC)
      - `completed-at` string, date-time, nullable — Date when the certificate expires. (UTC)
      - `url` string, nullable — URL of the certificate or issuer.
      - `issued-by` string, nullable — Institution that issued the certification.
      - `certificate-number` string, nullable — Certification number from the certifying institution.
    - `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)