---
title: "User certificate awarded"
method: POST
path: "user.certificate.awarded"
tags: ["User"]
---

# User certificate awarded

`POST user.certificate.awarded` (webhook)

Sent to your endpoint when a user certificate is awarded in your platform.

## Headers

- `webhook-signature` string, required
- `webhook-id` string, required
- `webhook-timestamp` string, required

## Payload

- object
  - `type` 'user.certificate.awarded', required: The type of the event.
  - `timestamp` integer, required: The date and time when the event was triggered in your platform, in the Unix epoch format (number of milliseconds that have elapsed since January 1, 1970).
  - `data` CertificateAwardedDTO, required
    - `userId` string, ObjectId, required: The unique ID of the user.
    - `certificateId` string, ObjectId, required: The unique ID of the awarded certificate.
    - `certificateOutlineId` string, ObjectId: The unique ID of the certificate outline linked to the awarded certificate.
    - `deliveryDate` string, date-time, required: The date and time when the user obtained the certificate, in the `YYYY-MM-DDThh:mm:ss.sssZ` format (ISO 8601 in Coordinated Universal Time (UTC)).
    - `pathId` string, ObjectId: The unique ID of the completed path where the certificate was awarded.
    - `pathSessionId` string, ObjectId: The unique ID of the completed path session where the certificate was awarded.

## Acknowledgement `2XX`

The event is considered as accepted for any 2xx response code.

## Other responses

- `default`: The event is considered as rejected for any other response code. The event emission will be retried later.

---

[API](https://skmtc.dev/360learning/apis/webhook-api.md) - [All operations](https://skmtc.dev/360learning/apis/webhook-api/llms.txt) - [OpenAPI document](https://skmtc.dev/360learning/apis/webhook-api/revisions/c2110549e263?raw)