Skip to Content
API ReferenceCoupons

Batch create coupons

Create multiple coupons in one request by sending a resources array.

Create multiple coupons in one request by sending a resources array.

Each resource supports the same product and variant scoping as the single-create endpoint. Set store_wide to false, provide products, and optionally provide product_variants. Each variant must belong to one of the selected products.

{
  "resources": [
    {
      "code": "STARTER10",
      "type": "PERCENTAGE",
      "discount": 10,
      "store_wide": false,
      "products": [123],
      "product_variants": [1001]
    }
  ]
}
POST
/v2/coupons/batch

Authorization

headerAuthorizationBearer <API Key>

Provide your SellApp API key as a bearer token.

Header Parameters

Idempotency-Key?string

Reuse this key only for an identical retry. A replay returns Idempotent-Replayed: true.

Length8 <= length <= 255
X-STORE?string

Store slug. Required for OAuth access tokens. API keys may omit it to use their current store, or the first accessible store when no current store is selected.

Request Body

application/json
  1. body
resources*array<>

Response Body

Successful response.

application/json
  1. response
data*array<>
Example Request
curl -X POST 'https://sell.app/api/v2/coupons/batch' \  -H 'Idempotency-Key: project-library-2026-09-04' \  -H 'X-STORE: launch-lab' \  -H 'Content-Type: application/json' \  -d '{  "resources": [    {      "code": "STARTER10",      "type": "PERCENTAGE",      "discount": 10,      "store_wide": false,      "products": [        123      ],      "product_variants": [        1001      ]    }  ]}'
{  "data": [    {      "id": 1,      "code": "STARTER10",      "type": "PERCENTAGE",      "discount": "10",      "limit": null,      "store_wide": false,      "minimum_amount": null,      "expires_at": null,      "created_at": "2026-08-30T12:00:01.000000Z",      "updated_at": "2026-08-30T12:00:01.000000Z",      "store_id": 1,      "deleted_at": null,      "products": [        123      ],      "product_variants": [        1001      ],      "maximum_discount_amount": null,      "applies_to": "one_time",      "subscription_payments": null    }  ]}