---
title: "Sends a custom award to recipients"
method: POST
path: "/v1/custom-awards/send"
---

# Sends a custom award to recipients

`POST /v1/custom-awards/send`

Sends a custom award to one or more recipients within the company.
Awards can include optional messages and point values. All recipients
must be valid user UUIDs within the organization.

## Request body

- union — Request body for sending custom awards. Either `recipientUuids`, `recipientEmails`, or both must be provided.
  - object
    - `awardUuid` string, required — UUID of the custom award template to send (required)
    - `recipientUuids` string[] — Array of recipient user UUIDs. Required if `recipientEmails` is not provided.
    - `recipientEmails` string[], required — Array of recipient user emails. Required if `recipientUuids` is not provided.
    - `message` string — Optional personal message to include with the award.
    - `points` number — Optional point value to include with the award (must be positive).
  - object
    - `awardUuid` string, required — UUID of the custom award template to send (required)
    - `recipientUuids` string[], required — Array of recipient user UUIDs. Required if `recipientEmails` is not provided.
    - `recipientEmails` string[] — Array of recipient user emails. Required if `recipientUuids` is not provided.
    - `message` string — Optional personal message to include with the award.
    - `points` number — Optional point value to include with the award (must be positive).

## Response `200`

Custom award sent successfully

- SuccessfulResponse
  - `status` 'success'
  - `links` Links
    - `self` string, uri
    - `related` object[]
      - `type` string
      - `href` string, uri

## Other responses

- `400` — `BAD REQUEST`: Body or Query Params are malformed (missing, extra, or invalid values)
- `401` — `UNAUTHORIZED`: Request was sent with an expired or missing API Key
- `403` — `FORBIDDEN`: Request was authenticated but the resource requested is missing or not accessible with that key
- `404` — `NOT FOUND`: The requested resource was not found
- `429` — `TOO MANY REQUESTS`: Company is being rate limited
- `500` — `INTERNAL SERVER ERROR`: Request was unable to be processed due to a server error. Contact our support team.
- `501` — `NOT IMPLEMENTED`: Method is not implemented on that endpoint.

---

[API](https://skmtc.net/nectarhr/apis/nectar-public-api.md) · [All operations](https://skmtc.net/nectarhr/apis/nectar-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nectarhr/nectar-public-api/revisions/c0dcbcafc495/schema)