---
title: "Create Reward Assignment"
method: POST
path: "/v1/rewards/{rewardId}/assignments"
tags: ["Rewards"]
---

# Create Reward Assignment

`POST /v1/rewards/{rewardId}/assignments`

Assigns a reward to a specified loyalty campaign.

## Request body

- union — Request body schema for **POST** `v1/rewards/{rewardID}/assignments`.
  - RewardsAssignmentsCreateDigitalOrMaterialRewardRequestBody — Request body schema for **POST** `v1/rewards/{rewardID}/assignments`.
    - `campaign` string, required — The campaign ID of the campaign to which the reward is to be assigned.
    - `parameters` object, required — Defines the cost of the reward.
      - `loyalty` object, required — Defines the equivalent points value of the reward.
        - `points` integer — Number of points that will be subtracted from the loyalty card points balance if the reward is redeemed. Must be positive integer.
        - `auto_redeem` boolean, nullable — Determines if the reward is redeemed automatically when the customer reaches the sufficient number of points to redeem it. Value `true` means that the automatic reward redemption is active. Only one reward can be set to be redeemed automatically in a loyalty campaign, i.e. only one can have the value `true`.
  - RewardsAssignmentsCreateCoinRewardRequestBody — Request body schema for **POST** `v1/rewards/{rewardID}/assignments`.
    - `campaign` string, required — The campaign ID of the campaign to which the reward is to be assigned.
    - `validation_rules` string[]

## Response `200`

Returns a reward assignment object.

- RewardsAssignmentsCreateResponseBody
  - `id` string, required — Unique reward assignment ID, assigned by Voucherify.
  - `reward_id` string, required — Associated reward ID.
  - `created_at` string, date-time, required — Timestamp representing the date and time when the reward assignment was created. The value is shown in the ISO 8601 format.
  - `updated_at` string, date-time, nullable, required — Timestamp representing the date and time when the reward assignment was updated. The value is shown in the ISO 8601 format.
  - `object` 'reward_assignment', required — The type of the object represented by the JSON. This object stores information about the reward assignment.
  - `related_object_id` string, required — Related object ID to which the reward was assigned.
  - `related_object_type` 'campaign', required — Related object type to which the reward was assigned.
  - `parameters` object — Defines the cost of the reward.
    - `loyalty` object, required — Defines the equivalent points value of the reward.
      - `points` integer — The number of points required to redeem the reward.
      - `auto_redeem` boolean, nullable — Determines if the reward is redeemed automatically when the customer reaches the sufficient number of points to redeem it. Value `true` means that the automatic reward redemption is active. Only one reward can be set to be redeemed automatically in a loyalty campaign, i.e. only one can have the value `true`.

## Other responses

- `400` — Returns an error if request body parameters are missing.
- `404` — Returns an error when creating a reward assignment for a reward that has been deleted or does not exist.
- `409` — Returns an error if a conflict is found, i.e. an assignment for the reward has already been created.

---

[API](https://skmtc.net/voucherifyio/apis/voucherify-api-async-actions.md) · [All operations](https://skmtc.net/voucherifyio/apis/voucherify-api-async-actions/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/voucherifyio/voucherify-api-async-actions/versions/4982266e0494/schema)