---
title: "Create a reward"
method: POST
path: "/loyalty/v1/rewards"
tags: ["Reward"]
---

# Create a reward

`POST /loyalty/v1/rewards`

Create a new reward that can be given to members.

## Request body

- object
  - `auto_generated` boolean
  - `custom_fields` CustomField[]
    - `name` string
    - `value` string
  - `description` string
  - `external_id` string, required
  - `forced_validity` boolean
  - `forced_validity_end` string
  - `forced_validity_start` string
  - `holding_days` integer, required
  - `image_url` string
  - `limited` boolean
  - `max_attribution_count` string
  - `monetary` boolean
  - `monetary_type` 'percentage' | 'value'
  - `monetary_value` number — Value of the reward (in percentage or currency)
  - `name` string, required
  - `nqp_value` integer, required — Non qualifying points price of the reward.
  - `rich_description` string
  - `validity_interval_count` integer
  - `validity_interval_type` 'days' | 'weeks' | 'months' | 'years'

## Response `201`

Reward creation is successful.

## Other responses

- `400` — The request validation failed.
- `401` — Authentication failed.
- `403` — Forbidden.

---

[API](https://skmtc.net/splio/apis/splio-customer-platform.md) · [All operations](https://skmtc.net/splio/apis/splio-customer-platform/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/splio/splio-customer-platform/versions/2ff4735f665c/schema)