Create customer groups
Bulk-creates customer groups. Successful entities are returned in data; per-item failures in errors keyed by the customer group slug.
POST
/api/v2/{team_slug}/{app_slug}/customer-groupsAuthorization
AuthorizationBearer token · headerrequiredManagement API token, sent as Authorization: Bearer <token>.
Path parameters
team_slugstringrequiredapp_slugstringrequiredRequest body
requiredapplication/jsoncustomer_groupsCreateCustomerGroupItem[]requiredmin items 1 · max items 20
Show propertiesHide properties
Array of
CreateCustomerGroupItemstore_group_idUUIDrequirednamestringrequiredslugstringrequiredtypestringrequireddiscount_percentageinteger | nulldiscount_percentage_decimalsinteger | nullResponses
201
Created (partial success possible)
dataCustomerGroup[]requiredShow propertiesHide properties
Array of
CustomerGroupidUUIDrequiredapp_idUUIDrequiredstore_group_idUUIDrequirednamestringrequiredslugstringrequiredtypestringrequireddiscount_percentageinteger | nulldiscount_percentage_decimalsinteger | nullcreated_atstring<date-time>requiredupdated_atstring<date-time>requirederrorsCustomerGroupError[]requiredShow propertiesHide properties
Array of
CustomerGroupErrorslugstringidUUID | nullShow propertiesHide properties
Any of:
UUID
string<uuid>null
nullmessagestringrequired400
Request-level failure
errorErrorBodyrequiredShow propertiesHide properties
messagestringrequireddetailsstring[]required401
Request-level failure
errorErrorBodyrequiredShow propertiesHide properties
messagestringrequireddetailsstring[]required403
Request-level failure
errorErrorBodyrequiredShow propertiesHide properties
messagestringrequireddetailsstring[]required500
Request-level failure
errorErrorBodyrequiredShow propertiesHide properties
messagestringrequireddetailsstring[]required