---
title: "Create new cashback distribution. For internal usage only"
method: POST
path: "/v1/cashback/"
tags: ["Cashback"]
---

# Create new cashback distribution. For internal usage only

`POST /v1/cashback/`

## Request body

- ApiCashbackCreateRequest
  - `title` string, required
  - `description` string, required
  - `distributor` string, required — Where rewards stored
  - `reward_token` string, required
  - `conditions` ApiDexSwapCondition[], required
    - `type` 'unique' | 'listed' | 'partner_address' | 'tokens' | 'tokens-pair' | 'tokens-exact' | 'users-whitelist' | 'swap-tx-min-amount' | 'blacklist-pair' | 'blacklist-tokens' | 'dexes', required
    - `args` string[] — Arguments required to construct condition type
  - `distribute` number, required — How many tokens will be distributed to users
  - `distributed` number, required — How many tokens already distributed to users
  - `start_time_seconds` integer, required — Begin cashback promo in unix seconds
  - `end_time_seconds` integer, required — End cashback promo in unix seconds
  - `reward_denominator` number, required
  - `is_hidden` boolean, required
  - `limits` ApiCashbackLimitCreateRequest[], required
    - `interval_duration_seconds` integer, required
    - `max_distribute_at_interval` number, required
  - `image_url` string, required
  - `references` ApiContentReference[], required
    - `ref_name` string, required
    - `ref_url` string, required

## Response `200`

Created cashback

- ApiCashbackInfo
  - `id` integer, required
  - `title` string, required
  - `description` string, required
  - `distributor` string, required — Where rewards stored
  - `reward_token` string, required
  - `conditions` ApiDexSwapCondition[], required
    - `type` 'unique' | 'listed' | 'partner_address' | 'tokens' | 'tokens-pair' | 'tokens-exact' | 'users-whitelist' | 'swap-tx-min-amount' | 'blacklist-pair' | 'blacklist-tokens' | 'dexes', required
    - `args` string[] — Arguments required to construct condition type
  - `distribute` number, required — How many tokens will be distributed to users
  - `distributed` number, required — How many tokens already distributed to users
  - `start_time_seconds` integer, required — Begin cashback promo in unix seconds
  - `end_time_seconds` integer, required — End cashback promo in unix seconds
  - `reward_denominator` number, required
  - `is_active` boolean, required — Can this cashback program accrue tokens to participants
  - `limits` ApiCashbackLimit[], required
    - `limit_id` integer, required
    - `interval_duration_seconds` integer, required
    - `max_distribute_at_interval` number, required
  - `image_url` string, required
  - `references` ApiContentReference[], required
    - `ref_name` string, required
    - `ref_url` string, required
  - `is_hidden` boolean, required

## Other responses

- `default` — Some error during request processing

---

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