---
title: "Create a new Coupon"
method: POST
path: "/v2/backoffice/coupons"
tags: ["Coupons API"]
---

# Create a new Coupon

`POST /v2/backoffice/coupons`

## Request

- Base URL: `https://app.metricool.com/api`
- URL: `https://app.metricool.com/api/v2/backoffice/coupons`
- Auth: none declared

## Request body

- CreateCouponRequest
  - `code` string
  - `amount` number
  - `billingCycles` integer
  - `expiresAt` DateTimeInfo
    - `dateTime` string, required: Local Date-time represented with a certain timezone
    - `timezone` string: Timezone applied to the datetime
  - `maxDiscounts` integer
  - `newUsers` boolean
  - `onlyAnnualPlans` boolean
  - `percentage` boolean
  - `hashTagBalance` integer
  - `trial` integer
  - `label` string
  - `assignedTeamCouponTracking` string

## Response `200`

OK

- JsonOkResponseCouponDto
  - `metadata` object
  - `page` JsonPaging
    - `next` string
  - `data` CouponDto
    - `id` integer
    - `owner` string
    - `ownerId` integer
    - `code` string
    - `createdAt` DateTimeInfo
      - `dateTime` string, required: Local Date-time represented with a certain timezone
      - `timezone` string: Timezone applied to the datetime
    - `amount` number
    - `percentage` boolean
    - `billingCycles` integer
    - `hashTagBalance` integer
    - `expiresAt` DateTimeInfo
      - `dateTime` string, required: Local Date-time represented with a certain timezone
      - `timezone` string: Timezone applied to the datetime
    - `maxDiscounts` integer
    - `discountCount` integer
    - `newUsers` boolean
    - `onlyAnnualPlans` boolean
    - `trial` integer
    - `revenue` number
    - `enabled` boolean
    - `assignedTeamCouponTracking` string
    - `label` string

---

[API](https://skmtc.dev/metricool/apis/metricool-api.md) · [All operations](https://skmtc.dev/metricool/apis/metricool-api/llms.txt) · [OpenAPI document](https://skmtc.dev/metricool/apis/metricool-api/revisions/aea9d9a8415a?raw)