---
title: "Load codes file"
method: PATCH
path: "/v1/promocodes/{promocodeId}/loadCodesFile"
tags: ["PromoCodeCommand"]
---

# Load codes file

`PATCH /v1/promocodes/{promocodeId}/loadCodesFile`

Notifies OptiPromo that a CSV file containing unique codes has been uploaded.

## Path parameters

- `promocodeId` string, required

## Request body

- PromocodecommandLoadCodesFile
  - `fileId` string
  - `filePath` string
  - `loadedCodesAmount` integer

## 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)