Create a coupon

This endpoint allows you to create a new coupon. See the code examples for how to create a new coupon with the SellApp API.

curl -X POST "https://sell.app/api/v1/coupons" \  -H "Content-Type: application/json" \  -d '{    "code": "string",    "type": "PERCENTAGE",    "discount": 0,    "store_wide": true  }'

{
  "data": {
    "id": 1,
    "code": "BONANZA",
    "type": "PERCENTAGE",
    "discount": "80",
    "limit": null,
    "store_wide": true,
    "minimum_amount": null,
    "expires_at": null,
    "created_at": "2022-12-12T12:12:12.000000Z",
    "updated_at": "2022-12-12T12:12:12.000000Z",
    "store_id": 1,
    "deleted_at": null
  }
}

Limit a coupon to specific products

Set store_wide to false and include a products array containing the product IDs the coupon should apply to. Use product/listing IDs, not product variant IDs.

{
  "code": "PRODUCT10",
  "type": "PERCENTAGE",
  "discount": 10,
  "store_wide": false,
  "products": [123, 456]
}

When store_wide is true, the API ignores product scoping and the coupon applies to every product in the store.