Ordergroove Developer Documentation

curl -X PATCH https://restapi.ordergroove.com/retention_incentives/eligibility_rule/public_id/ \
     -H "x-api-key: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "name": "Retention discount 2",
  "live": true,
  "min_days_since_last_claim": 30,
  "min_subscriber_orders_since_last_claim": 5,
  "incentive_templates": [
    {
      "type": "Discount",
      "target": "item",
      "discount_type": "Discount Percent",
      "field": "total_price",
      "value": "10.00",
      "name": "Incentive template discount"
    }
  ]
}'

{
  "public_id": "a65babf9c7e44da1bc3c8020d8a80580",
  "name": "Retention discount 2",
  "merchant": "07f5cbbc9c0811ed99a9f2d3525685ca",
  "live": true,
  "min_days_since_last_claim": 30,
  "min_subscriber_orders_since_last_claim": 5,
  "incentive_templates": [
    {
      "name": "Incentive template discount",
      "type": "Discount",
      "field": "total_price",
      "discount_type": "Discount Percent",
      "value": "10.00",
      "target": "item"
    }
  ]
}

Updates a retention incentive eligibility rule with their incentive templates.

Authentication

x-api-keystring

API Key authentication via header

Path parameters

public_idstringRequired

Request

This endpoint expects an object.

namestringOptional

Anything to help identify this rule

livebooleanOptional

Active / inactive state for this rule

min_days_since_last_claimintegerOptional

Minimum number of days since the last retention incentive has been claimed for a given customer

min_subscriber_orders_since_last_claimintegerOptional

Minimum number of orders that had to be placed since the last retention incentive was claimed for a given customer

incentive_templateslist of objectsOptional

Response

200

public_idstringOptional

namestringOptional

merchantstringOptional

livebooleanOptionalDefaults to true

min_days_since_last_claimintegerOptionalDefaults to 0

min_subscriber_orders_since_last_claimintegerOptionalDefaults to 0

incentive_templateslist of objectsOptional

Errors

400

Bad Request Error