# キャンペーンを作成

新しいクーポンキャンペーンを作成します。

通知APIコールにproject_idパスパラメータが含まれていないため、会社の全プロジェクトで有効なAPIキーを使用して認可を設定する必要があります。

Endpoint: POST /merchants/{merchant_id}/coupon_promotions
Version: 2.0
Security: basicAuth

## Path parameters:

  - `merchant_id` (integer, required)
    マーチャントID。

## Request fields (application/json):

  - `campaign_code` (string, required)
    キャンペーンの名前。

  - `campaign_names` (object, required)
    ローカライズしたキャンペーン名を含むオブジェクト。

  - `campaign_names.ar` (string)
    アラビア語。

  - `campaign_names.bg` (string)
    ブルガリア語。

  - `campaign_names.cn` (string)
    中国語（簡体字）。

  - `campaign_names.cs` (string)
    チェコ語。

  - `campaign_names.de` (string)
    ドイツ語。

  - `campaign_names.en` (string)
    英語。

  - `campaign_names.es` (string)
    スペイン語。

  - `campaign_names.fr` (string)
    フランス語。

  - `campaign_names.he` (string)
    ヘブライ語。

  - `campaign_names.it` (string)
    イタリア語。

  - `campaign_names.ja` (string)
    日本語。

  - `campaign_names.ko` (string)
    韓国語。

  - `campaign_names.pl` (string)
    ポーランド語。

  - `campaign_names.pt` (string)
    ポルトガル語。

  - `campaign_names.ro` (string)
    ルーマニア語。

  - `campaign_names.ru` (string)
    ロシア語。

  - `campaign_names.th` (string)
    タイ語。

  - `campaign_names.tr` (string)
    トルコ語。

  - `campaign_names.tw` (string)
    中国語（繁体字）。

  - `campaign_names.vi` (string)
    ベトナム語。

  - `campaign_redeems_count_for_user` (integer)
    キャンペーン内で、ユーザーごとに交換できるクーポンの最大数。nullが渡されたら、交換数に制限はありません。

  - `expiration_date` (string)
    [ISO8601](https://en.wikipedia.org/wiki/ISO_8601)に準拠した「YYYY-MM-DD’T’HH:MM:SS」形式のキャンペーンの有効期限。

  - `project_id` (integer, required)
    プロジェクトID。

  - `redeems_count` (integer)
    クーポンの最大交換数。nullが渡されると、交換数に制限はありません。

  - `redeems_count_for_user` (integer)
    ユーザーごとに交換できるクーポンの最大数。nullが渡されたら、交換数に制限はありません。

  - `subscription_coupon` (object)
    Object containing subscription parameters in a reward.

  - `subscription_coupon.plan_id` (integer, required)
    サブスクリプションプラン ID。

  - `subscription_coupon.product_id` (integer, required)
    サブスクリプション製品 ID。

  - `subscription_coupon.trial_period` (integer, required)
    試用期間（日数）。

  - `virtual_currency_amount` (number)
    報酬の仮想通貨額。

  - `virtual_items` (object)
    報酬の仮想アイテムパラメーターの配列。

  - `virtual_items.quantity` (integer, required)
    仮想アイテム数量。

  - `virtual_items.sku` (string, required)
    仮想アイテムSKU。

## Response 201 fields (application/json):

  - `id` (integer)
    Example: 9134