# 캠페인 생성

새로운 쿠폰 캠페인을 생성합니다.

  주의이 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 name.

  - `campaign_names` (object, required)
    Object containing localized campaign names.

  - `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)
    [ISO 8601 ](https://en.wikipedia.org/wiki/ISO_8601)에 따라 YYYY-MM-DD’T’HH:MM:SS 형식으로 되어 있는 캠페인 만료일입니다.

  - `project_id` (integer, required)
    Project 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 currency amount in a reward.

  - `virtual_items` (object)
    Array of virtual items parameters in a reward.

  - `virtual_items.quantity` (integer, required)
    가상 아이템 수량입니다.

  - `virtual_items.sku` (string, required)
    가상 아이템 SKU입니다.

## Response 201 fields (application/json):

  - `id` (integer)
    Example: 9134