---
title: "Credit Reward Item"
method: POST
path: "/profiles/{profile_id}/reward-item-credits/"
---

# Credit Reward Item

`POST /profiles/{profile_id}/reward-item-credits/`

## Request

- Base URL: `https://cf-blast.livelikecdn.com/api/v1`
- URL: `https://cf-blast.livelikecdn.com/api/v1/profiles/{profile_id}/reward-item-credits/`
- Auth: none required

Credit reward item points to a user profile

## Path parameters

- `profile_id` string, required

## Request body

- object
  - `reward_item_id` string, required
  - `reward_item_amount` integer, required
  - `description` string: optional description for crediting the reward. eg. attended an away game vs Atlanta Braves on April 30th
  - `custom_data` string: String data to send with the reward item credit. Typically contains a string JSON payload to be decoded by the client SDK
  - `attributes` object[]: Key/value set of attributes to create that will be linked to the reward item
    - `key` string, required
    - `value` string, required
  - `reason` string: Optional reason for crediting the reward. eg. attend a game
  - `leaderboard_ids` string[]: List of leaderboard UUIDs to update; if provided, only those leaderboards are updated; if empty ([]), no linked leaderboards are updated; if omitted, all linked leaderboards are updated.
  - `expires_at` string, date: Date after which the credited amount stops counting toward the profile's balance. Must be today or later, and can't exceed the reward item's earning_ends_at.
  - `idempotency_key` string: Client-supplied dedup token — replaying the same key returns/short-circuits the existing transaction instead of creating a duplicate.

## Response `200`

200

## Other responses

- `400`: 400

## Changes

- **2026-11-03** `3e5529c26ce4`: 2 info
  - added the new optional request property `expires_at`
  - added the new optional request property `idempotency_key`

[Operation history](https://skmtc.dev/livelike/apis/engagement-suite/changes/profiles/:profile_id/reward-item-credits/post.md)

---

[API](https://skmtc.dev/livelike/apis/engagement-suite.md) - [All operations](https://skmtc.dev/livelike/apis/engagement-suite/llms.txt) - [OpenAPI document](https://skmtc.dev/livelike/apis/engagement-suite/revisions/3e5529c26ce4?raw)
