Skip to main content
POST
/
v1
/
imports
/
coupons
Batch Create Coupons
curl --request POST \
  --url https://{defaultHost}/v1/imports/coupons \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "import": {
    "data": [
      {
        "name": "Test Coupon",
        "amount_off": 500
      }
    ]
  }
}
'
{
  "id": "46a34c2d-e0b1-48e5-a512-a385b3c468b5",
  "object": "import",
  "import_type": "coupon",
  "live_mode": true,
  "rows_imported": 0,
  "rows_uploaded": 0,
  "status": "pending",
  "created_at": 1767909707,
  "updated_at": 1767909707
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
import_coupons
object

Response

200 - application/json

Success

​
id
string | null

The UUID of the specific object.

​
object
string

A string describing the object type returned.

​
import_type
string

The type of record imported – one of customer, product, coupon, purchase, or subscription.

​
import_rows
array

A list of associated import rows.

​
rows_imported
integer

The number of rows successfully imported.

​
status
string

The status of the import – one of completed, invalid, pending, or processing.

​
created_at
integer | null

Time at which the object was created. Measured in seconds since the Unix epoch.

​
updated_at
integer | null

Time at which the object was last updated. Measured in seconds since the Unix epoch.