---
title: "Create new coupon code"
description: "Create a new coupon code and return its persistent data. Requires writable `pricelists` permission. Has dependency on `coupon`."
canonical_url: "https://www.zeyos.com/api/create-coupon-code"
markdown_url: "https://www.zeyos.com/ai/guide/api/create-coupon-code.md"
section: "api-reference"
authority: "reference"
language: "en"
source_repository: "https://cloud.zeyos.com/__doc/openapi/api.json"
source_sha256: "f5850c6fa6f99a1b518fc8ddc4e566070b53b5506cde57a3299948d38fc6363c"
---

# Create new coupon code

`PUT /couponcodes`

- Summary: Create new coupon code
- OperationId: createCouponCode
- Description: Create a new coupon code and return its persistent data. Requires writable `pricelists` permission. Has dependency on `coupon`.

Parameters:
- (none)

Request body:
- #/components/requestBodies/couponcodes

Responses:
- 201 — Successful Creation (Created)
  - application/json — #/components/schemas/couponcodes
- 401: #/components/responses/401
- 403: #/components/responses/403
- 409 — ID Present (Conflict)
- 410 — Gone
- 500: #/components/responses/500

Full tag reference: /ai/openapi/tag.couponcodes.md
OpenAPI slice: /ai/openapi/tag.couponcodes.openapi.json