---
title: "Create Discount Code"
method: POST
path: "/events/{event_id}/discount-codes"
tags: ["Attendees"]
---

# Create Discount Code

`POST /events/{event_id}/discount-codes`

## Request

- Base URL: `https://api.confbuilder.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.confbuilder.com/events/{event_id}/discount-codes`
- Auth: none declared

## Path parameters

- `event_id` string, required

## Request body

- DiscountCodeCreate
  - `eventId` string, uuid, required
  - `code` string, required
  - `description` string, nullable
  - `descriptionForOrganizer` string, nullable
  - `discountType` string
  - `value` number
  - `quantity` integer, nullable
  - `minQuantityPerRelease` integer, nullable
  - `maxQuantityPerRelease` integer, nullable
  - `startAt` string, date-time, nullable
  - `endAt` string, date-time, nullable
  - `isActive` boolean
  - `showPublicReleases` string
  - `showSecretReleases` string
  - `ticketTypeIds` string[], nullable

## Response `201`

Successful Response

- DiscountCodeBase
  - `eventId` string, uuid, required
  - `code` string, required
  - `description` string, nullable
  - `descriptionForOrganizer` string, nullable
  - `discountType` string
  - `value` number
  - `quantity` integer, nullable
  - `minQuantityPerRelease` integer, nullable
  - `maxQuantityPerRelease` integer, nullable
  - `startAt` string, date-time, nullable
  - `endAt` string, date-time, nullable
  - `isActive` boolean
  - `showPublicReleases` string
  - `showSecretReleases` string
  - `ticketTypeIds` string[], nullable
  - `id` string, uuid, nullable
  - `quantityUsed` integer
  - `registrationsCount` integer
  - `eventSlug` string, nullable
  - `createdAt` string, date-time, nullable
  - `updatedAt` string, date-time, nullable
  - `discountState` string, required: Computed state: 'upcoming', 'current', 'past', or 'exhausted'.
  - `shareUrl` string, nullable, required: Shareable URL that auto-applies the code.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/confbuilder/apis/confbuilder-api.md) · [All operations](https://skmtc.dev/confbuilder/apis/confbuilder-api/llms.txt) · [OpenAPI document](https://skmtc.dev/confbuilder/apis/confbuilder-api/revisions/9e576d664e16?raw)