---
title: "Create a promocode"
method: POST
path: "/v1/promocodes"
tags: ["PromoCodeCommand"]
---

# Create a promocode

`POST /v1/promocodes`

Create a new promocode with the specified promocode ID. The promocode ID must be unique and not already in use. The promocode ID is an optional field. If not provided, the system will generate a unique promocode ID.

## Query parameters

- `promocodeId` string

## Request body

- PromocodecommandCreate
  - `promotionId` string

## Response `200`

A successful response.

- PromocodecommandserviceTransactionCommittedResponse
  - `requestId` string
  - `promocodeId` string
  - `availableCommands` PromocodecommandAvailableCommand[]
    - `command` 'CREATE' | 'LINK_CAMPAIGN' | 'UNLINK_CAMPAIGN' | 'HIDE' | 'SHOW' | 'LOAD_CODES_FILE' | 'CONFIGURE_PERSONALIZED' | 'REASSIGN_PROMOTION' | 'SET_TYPE' | 'CONFIGURE_CUSTOMER_SORTING' | 'CONFIGURE_CODES_ALERT'
    - `url` string
    - `httpMethod` 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH'
  - `events` PromocodeeventEvent[]
    - `revision` integer
    - `created` PromocodeeventCreated
    - `promotionAssigned` EventPromotionAssigned
      - `promotionId` string
    - `promotionUnassigned` EventPromotionUnassigned
      - `promotionId` string
    - `campaignLinked` EventCampaignLinked
      - `campaignId` string
      - `promotionId` string
    - `campaignUnlinked` EventCampaignUnlinked
      - `campaignId` string
      - `promotionId` string
    - `hidden` EventHidden
    - `shown` EventShown
    - `codesFileLoaded` EventCodesFileLoaded
      - `fileId` string
      - `filePath` string
      - `loadedCodesAmount` integer
      - `promotionId` string
    - `personalizedConfigured` EventPersonalizedConfigured
      - `fallbackConfig` 'UNKNOWN' | 'USE_FALLBACK_CODE' | 'REJECT_CUSTOMER'
      - `allocationConfig` 'UNSET' | 'ALWAYS_NEW_CODE' | 'ONE_CODE_PER_CUSTOMER'
      - `promotionId` string
    - `typeSet` EventTypeSet
      - `type` 'GENERIC' | 'PERSONALIZED' | 'NO_CODE'
      - `promotionId` string

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.net/optimove/apis/optimove-api.md) · [All operations](https://skmtc.net/optimove/apis/optimove-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/optimove/optimove-api/revisions/fc55c5b1bec5/schema)