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
header
AuthorizationBearer <API Key>Provide your SellApp API key as a bearer token.
Idempotency-Key?stringReuse this key only for an identical retry. A replay returns Idempotent-Replayed: true.
Length
8 <= length <= 255X-STORE?stringStore 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.
application/json- body
resources*array<>Successful response.
application/json- response
data*array<>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 } ]}