# Katalogsonderangebot erstellen

Erstellt ein Katalogsonderangebot.

Endpoint: POST /v3/project/{project_id}/admin/unique_catalog_offer
Version: 2.0.0
Security: basicAuth

## Path parameters:

  - `project_id` (integer, required)
    Projekt-ID. Dieser Parameter wird im Kundenportal neben dem Projektnamen angezeigt.
    Example: 44056

## Request fields (application/json):

  - `date_end` (string,null)
    Datum, an dem Ihre Werbeaktion endet. Möglich ist null. Wenn für date_end der Wert null festgelegt ist, läuft die Werbeaktion zeitlich unbegrenzt.

  - `date_start` (string,null)
    Datum, an dem Ihre Werbeaktion beginnt.

  - `external_id` (string, required)
    Eindeutige Werbeaktions-ID. Die external_id darf nur lateinische Klein- und Großbuchstaben, Ziffern, Punkte, Bindestriche und Unterstriche enthalten.
    Example: "coupon_external_id"

  - `items` (array)
    Eine Liste der Artikel-SKU, die nach Inanspruchnahme des Katalogsonderangebots verfügbar sind.
    Example: ["booster_mega_1"]

  - `name` (object, required)
    Name der Werbeaktion. Sollte Schlüssel-Wert-Paare enthalten,
wobei der Schlüssel ein Gebietsschema im Format "^[a–z]{2}-[A–Z]{2}$" und der Wert ein String ist.
    Example: {"de-DE":"Gutscheintitel","en-US":"Coupon title"}

  - `redeem_code_limit` (integer,null)
    Anzahl der Einlösungen pro Code.
    Example: 10

  - `redeem_total_limit` (integer,null)
    Begrenzt die Gesamtzahl der Gutscheine.
    Example: 10

  - `redeem_user_limit` (integer,null)
    Begrenzt, wie oft ein einzelner Nutzer Gutscheine einlösen darf.
    Example: 10

## Response 201 fields (application/json):

  - `external_id` (string)
    Eindeutige Werbeaktions-ID. Die external_id darf nur lateinische Klein- und Großbuchstaben, Ziffern, Punkte, Bindestriche und Unterstriche enthalten.
    Example: "coupon_external_id"

## Response 401 fields (application/json):

  - `errorCode` (integer)
    Example: 1020

  - `errorMessage` (string)
    Example: "[0401-1020]: Error in Authentication method occurred"

  - `statusCode` (integer)
    Example: 401

## Response 422 fields (application/json):

  - `errorCode` (integer)
    Example: 1102

  - `errorMessage` (string)
    Example: "[0401-1102]: Unprocessable Entity. The property `external_id` is required"

  - `statusCode` (integer)
    Example: 422