---
title: "Redeem My Promo Code"
method: POST
path: "/me/promo-codes/redeem"
tags: ["me"]
---

# Redeem My Promo Code

`POST /me/promo-codes/redeem`

Assign an enterable promo code to the authenticated user.

## Request body

- RedeemPromoCodeRequest — Request to assign an enterable promo code to a user.
  - `code` string, required

## Response `200`

Successful Response

- UserPromoCodeResponse — Promo code assigned to a user.
  - `id` string, uuid, required
  - `code` string, required
  - `benefit_config` PromoCodeBenefitConfig, required — Machine-readable promo benefit configuration.
    - `category` string, required — Benefit type, e.g. percentage_discount, fixed_amount, flat_override
    - `amount` union, required — Discount amount for the category
      - integer
      - number
    - `metadata` object — Additional rule metadata for future promo engines
  - `assigned_at` string, date-time, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/helloaxel/apis/client-api-gateway.md) · [All operations](https://skmtc.dev/helloaxel/apis/client-api-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/helloaxel/client-api-gateway/revisions/d3c4c29fede7/schema)