---
title: "Create redemption"
method: POST
path: "/coupons/{couponId}/redemptions"
tags: ["Redemptions"]
deprecated: true
---

# Create redemption

`POST /coupons/{couponId}/redemptions`

## Request

- Base URL: `https://api.fabric.inc/v3`
- URL: `https://api.fabric.inc/v3/coupons/{couponId}/redemptions`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/fabric/apis/offers-redemptions/docs/coupons/:couponId/redemptions/post.ts> (a function with typed inputs; its response is checked against the schema)

> **Deprecated.**

Creates a redemption for a specific coupon using the corresponding `couponId` value.

## Path parameters

- `couponId` string, required

## Headers

- `x-fabric-tenant-id` string, required
- `x-fabric-channel-id` string
- `x-client-id` string
- `x-fabric-request-id` string

## Request body

- CreateRedemptionRequestDeprecated: Coupon redemption details
  - `couponCode` string, required: Coupon code to be redeemed
  - `orderId` string, required: Purchase order ID associated with the coupon redemption
  - `userId` string, nullable: ID of the user who redeems the coupon
  - `email` string, nullable: Email address of the user who redeems the coupon

## Response `201`

Created

- CreateRedemptionResponseDeprecated: Coupon's redemption details
  - `id` string, required: A 24-character system-generated redemption ID.
  - `couponId` string, required: A 24-character system-generated coupon ID generated using the [create coupon](/v3/api-reference/offers/coupons/create-coupon) endpoint.
  - `couponCode` string, required: Coupon code to redeem
  - `orderId` string, required: Purchase order ID associated with the coupon redemption
  - `userId` string: ID of the user who redeems the coupon
  - `email` string, nullable: Email address of the user who redeems the coupon
  - `createdAt` string, date-time: The timestamp in UTC format of when the coupon redemption was created.
  - `updatedAt` string, date-time: The timestamp in UTC format of when the coupon redemption was last updated.

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `500`: Internal server error

---

[API](https://skmtc.dev/fabric/apis/offers-redemptions.md) - [All operations](https://skmtc.dev/fabric/apis/offers-redemptions/llms.txt) - [OpenAPI document](https://skmtc.dev/fabric/apis/offers-redemptions/revisions/1ecebae0c30d?raw)