Create

POST

https://restapi.ordergroove.com/one_time_incentives/create/

Creates a one-time discount and attaches it to a specific item, order, or shipping rate for an individual customer.

x-api-keystring

API Key authentication via header

This endpoint expects an object.

merchantstringRequired

Merchant ID

customerstringRequired

Customer ID

descriptionstringOptional

Description

expiresdateOptional

Date by which Order Must Place to Apply discount

itemstringOptional

Send Item ID to apply a One Time Incentive to a specific item. This field and order are mutually exclusive, but one is required.

orderstringOptional

Send Order ID to apply a One Time Incentive to a specific order. This field and item are mutually exclusive, but one is required.

stacking_typestringOptionalDefaults to base

Choose ‘base’ or ‘additional’ for a standard discount or an additive one (defaults to ‘base’)

external_codestringOptional

External Code

incentiveobjectOptional

Incentive Object

201

One Time Item Discountobject

One Time Order Total Discountobject

One Time Order Shipping Discountobject

One Time Order Total Discount (With Threshold)object

One Time All Order Items Discountobject

400

Bad Request Error

$	curl -X POST https://restapi.ordergroove.com/one_time_incentives/create/ \
>	-H "x-api-key: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"merchant": "ac4f7938383a11e89ecbbc764e1107f2",
>	"customer": "00026001",
>	"description": "One-Time Order Total Discount",
>	"expires": "2024-05-21 00:00:00",
>	"order": "a4f656f6ed4511eebfaf6a353c182723",
>	"stacking_type": "base",
>	"external_code": "one_time_order_total_discount",
>	"incentive": {
>	"name": "One-Time Order Total Discount",
>	"discount_type": "Discount Amount",
>	"value": "25.00",
>	"field": "sub_total",
>	"type": "Discount",
>	"target": "order"
>	}
>	}'