> ## Documentation Index
> Fetch the complete documentation index at: https://docs.partnero.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create coupon API

> Create discount coupons for affiliate tracking. Percentage or fixed amount discounts with duration and redemption limits.

Create coupons that can be assigned to partners via promotion codes. When customers use these codes at checkout, sales are attributed to the partner for commission calculation.

## Endpoint

```
POST https://api.partnero.com/v1/coupons
```

## Request Body

| Parameter                         | Type    | Required | Description                                            |
| --------------------------------- | ------- | -------- | ------------------------------------------------------ |
| `name`                            | string  | No       | Customer-facing name (defaults to uuid\_code)          |
| `uuid_code`                       | string  | No       | Unique identifier (auto-generated if not provided)     |
| `active`                          | boolean | Yes      | Whether coupon is active                               |
| `coupon_discount_type`            | string  | Yes      | `percent` or `static`                                  |
| `coupon_discount_amount`          | number  | Yes      | Discount value (0-100 for percent, or fixed amount)    |
| `coupon_duration_type`            | string  | Yes      | `once`, `hours`, `days`, `months`, `years`, `lifetime` |
| `coupon_duration_value`           | integer | Yes\*    | Required for hours, days, months, years                |
| `redemption_specific_date_status` | boolean | No       | Enable expiration date                                 |
| `redemption_specific_date_value`  | date    | Yes\*    | Required if date status is true                        |
| `redemption_times_status`         | boolean | No       | Enable redemption limit                                |
| `redemption_times_value`          | integer | Yes\*    | Required if times status is true                       |
| `promotion_codes`                 | array   | No       | Array of promotion codes to create                     |
| `metadata`                        | object  | No       | Custom key-value pairs                                 |

## Request

```bash cURL theme={null}
curl --location 'https://api.partnero.com/v1/coupons' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "PARTNERO25",
    "uuid_code": "coupon_123",
    "active": true,
    "coupon_discount_type": "percent",
    "coupon_discount_amount": 25,
    "coupon_duration_type": "months",
    "coupon_duration_value": 11,
    "redemption_times_status": true,
    "redemption_times_value": 24
  }'
```

## Response

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "data": {
      "name": "PARTNERO25",
      "uuid_code": "coupon_123",
      "active": true,
      "coupon_discount_type": "percent",
      "coupon_discount_amount": 25,
      "coupon_duration_type": "months",
      "coupon_duration_value": 11,
      "redemption_specific_date_status": false,
      "redemption_specific_date_value": null,
      "redemption_times_status": true,
      "redemption_times_value": 24,
      "metadata": [],
      "created_at": "2025-05-07T17:43:26.000000Z",
      "updated_at": "2025-05-07T17:43:26.000000Z",
      "deleted_at": null
    },
    "status": 1,
    "message": "Coupon created in the app successfully.",
    "synchronization_enabled": false,
    "synchronization_successful": false,
    "synchronization_message": ""
  }
  ```
</ResponseExample>

<Note>
  If you have Stripe integration enabled, coupons can be automatically synced to your Stripe account.
</Note>