---
title: "PATCH /coupons/coupon/{couponName}/promo-codes/set-activation"
method: PATCH
path: "/coupons/coupon/{couponName}/promo-codes/set-activation"
tags: ["Promo Codes"]
---

# PATCH /coupons/coupon/{couponName}/promo-codes/set-activation

`PATCH /coupons/coupon/{couponName}/promo-codes/set-activation`

## Request

- The document declares no server URL.
- Auth: none required
- TypeScript: <https://skmtc.dev/appcharge/apis/grant-award/docs/coupons/coupon/:couponName/promo-codes/set-activation/patch.ts> (a function with typed inputs; its response is checked against the schema)

Activates or deactivates promo codes for a specific coupon. <br/><br/> Maximum of 1,000 promo code names allowed per request.

## Request body

- PromoCodeActivationRequest
  - `active` boolean, required: Whether to activate or deactivate the specified promo codes.
  - `promoCodeNames` string[], required: List of promo code names to activate or deactivate.

## Response `200`

Promo codes updated successfully.

- PromoCodeActivationResponse
  - `promoCodes` PromoCode[]: List of updated promo codes.
    - `name` string: Promo code name.
    - `active` boolean: Whether the promo code is active.
    - `maxRedemptions` integer: Maximum number of times this promo code can be redeemed.
    - `createdAt` string, date-time: Timestamp when the promo code was created.
    - `updatedAt` string, date-time: Timestamp when the promo code was last updated.
    - `redemptions` integer: Number of times this promo code has been redeemed.

## Other responses

- `400`: Bad request. Invalid input or validation failure.
- `404`: Coupon not found.
- `500`: Unexpected error.

---

[API](https://skmtc.dev/appcharge/apis/grant-award.md) - [All operations](https://skmtc.dev/appcharge/apis/grant-award/llms.txt) - [OpenAPI document](https://skmtc.dev/appcharge/apis/grant-award/revisions/b4f6759240d5?raw)