# Create Campaign

Create a new coupon campaign.

  NoticeThis API call does not contain the project_id path-parameter, so you need to use the API key that is valid in all the company’s projects to set up authorization.

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

## Path parameters:

  - `merchant_id` (integer, required)
    Merchant ID.

## Request fields (application/json):

  - `campaign_code` (string, required)
    Campaign name.

  - `project_id` (integer, required)
    Project ID.

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

  - `campaign_names.en` (string)
    English.

  - `campaign_names.ru` (string)
    Russian.

  - `campaign_names.cs` (string)
    Czech.

  - `campaign_names.ar` (string)
    Arabic.

  - `campaign_names.bg` (string)
    Bulgarian.

  - `campaign_names.cn` (string)
    Chinese (Simplified).

  - `campaign_names.tw` (string)
    Chinese (Traditional).

  - `campaign_names.fr` (string)
    French.

  - `campaign_names.de` (string)
    German.

  - `campaign_names.he` (string)
    Hebrew.

  - `campaign_names.it` (string)
    Italian.

  - `campaign_names.ko` (string)
    Korean.

  - `campaign_names.pl` (string)
    Polish.

  - `campaign_names.pt` (string)
    Portuguese.

  - `campaign_names.ro` (string)
    Romanian.

  - `campaign_names.es` (string)
    Spanish.

  - `campaign_names.th` (string)
    Thai.

  - `campaign_names.tr` (string)
    Turkish.

  - `campaign_names.vi` (string)
    Vietnamese.

  - `campaign_names.ja` (string)
    Japanese.

  - `expiration_date` (string)
    Campaign expiration date in the YYYY-MM-DD’T’HH:MM:SS format per [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601).

  - `virtual_currency_amount` (number)
    Virtual currency amount in a reward.

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

  - `virtual_items.sku` (string, required)
    Virtual item SKU.

  - `virtual_items.quantity` (integer, required)
    Virtual items quantity.

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

  - `subscription_coupon.plan_id` (integer, required)
    Subscription plan ID.

  - `subscription_coupon.product_id` (integer, required)
    Subscription product ID.

  - `subscription_coupon.trial_period` (integer, required)
    Trial period duration in days.

  - `redeems_count` (integer)
    Maximum number of coupon redeems. If null is passed, the redeems number is unlimited.

  - `redeems_count_for_user` (integer)
    Maximum number of coupon redeems per user. If null is passed, the redeems number is unlimited.

  - `campaign_redeems_count_for_user` (integer)
    Maximum number of coupon redeems per user within a campaign. If null is passed, the redeems number is unlimited.

## Response 201 fields (application/json):

  - `id` (integer)
    Example: 9134