Shipping Promotion Code Samples

1
{
2
  "name": "Buy two of X, buy two of Y and get free shipping to all zones",
3
  "redemption_type": "AUTOMATIC",
4
  "rules": [
5
    {
6
      "action": {
7
        "shipping": {
8
          "free_shipping": true,
9
          "zone_ids": "*"
10
        }
11
      },
12
      "apply_once": true,
13
      "stop": false,
14
      "currency_code": "AUD",
15
      "condition": {
16
        "and": [
17
          {
18
            "cart": {
19
              "items": {
20
                "products": [
21
                  118
22
                ]
23
              },
24
              "minimum_quantity": 2
25
            }
26
          },
27
          {
28
            "cart": {
29
              "items": {
30
                "variants": [
31
                  134
32
                ]
33
              },
34
              "minimum_quantity": 2
35
            }
36
          }
37
        ]
38
      }
39
    }
40
  ],
41
  "notifications": [],
42
  "stop": false,
43
  "status": "ENABLED",
44
  "start_date": "2019-02-06T05:00:00+00:00",
45
  "end_date": "2019-02-09T04:59:59+00:00"
46
}

{
  "name": "Order at least X units of product Y and get free shipping to specific shipping zones",
  "redemption_type": "AUTOMATIC",
  "rules": [
    {
      "action": {
        "shipping": {
          "free_shipping": true,
          "zone_ids": [
            2,
            3
          ]
        }
      },
      "apply_once": true,
      "stop": false,
      "condition": {
        "cart": {
          "items": {
            "products": [
              129
            ]
          },
          "minimum_quantity": 1
        }
      }
    }
  ],
  "notifications": [
    {
      "type": "UPSELL",
      "content": "Get free shipping for purchasing Twine Stand with Cutter. Limited to first 50 customers!\r\n<div>&nbsp;</div>",
      "locations": [
        "HOME_PAGE",
        "PRODUCT_PAGE",
        "CART_PAGE",
        "CHECKOUT_PAGE"
      ]
    },
    {
      "type": "ELIGIBLE",
      "content": "You are eligible for free shipping.\r\n<div>&nbsp;</div>",
      "locations": [
        "CART_PAGE"
      ]
    },
    {
      "type": "APPLIED",
      "content": "Congratulations you get free shipping!\r\n<div>&nbsp;</div>",
      "locations": [
        "CART_PAGE"
      ]
    }
  ],
  "stop": false,
  "max_uses": 50,
  "start_date": "2019-02-01T05:00:00+00:00",
  "end_date": "2019-02-05T04:59:59+00:00",
  "status": "ENABLED"
}

1
{
2
  "name": "Order at least 2X of product and get free shipping",
3
  "redemption_type": "AUTOMATIC",
4
  "rules": [
5
    {
6
      "action": {
7
        "shipping": {
8
          "free_shipping": true,
9
          "zone_ids": "*"
10
        }
11
      },
12
      "apply_once": true,
13
      "stop": false,
14
      "condition": {
15
        "cart": {
16
          "items": {
17
            "products": [
18
              129
19
            ]
20
          },
21
          "minimum_quantity": 2
22
        }
23
      }
24
    }
25
  ],
26
  "notifications": [
27
    {
28
      "type": "UPSELL",
29
      "content": "<div>&nbsp;</div>",
30
      "locations": [
31
        "CART_PAGE"
32
      ]
33
    },
34
    {
35
      "type": "ELIGIBLE",
36
      "content": "<div>&nbsp;</div>",
37
      "locations": [
38
        "CART_PAGE"
39
      ]
40
    },
41
    {
42
      "type": "APPLIED",
43
      "content": "<div>&nbsp;</div>",
44
      "locations": [
45
        "CART_PAGE"
46
      ]
47
    }
48
  ],
49
  "stop": false,
50
  "status": "ENABLED",
51
  "start_date": "2019-02-06T05:00:00+00:00",
52
  "end_date": "2019-02-09T04:59:59+00:00"
53
}

1
{
2
  "name": "Spend at least $100 and get $10 off shipping (specific methods)",
3
  "redemption_type": "AUTOMATIC",
4
  "rules": [
5
    {
6
      "action": {
7
        "shipping_discount": {
8
          "discount": { "fixed_amount": 10 },
9
          "method_ids": [1, 3]
10
        }
11
      },
12
      "apply_once": true,
13
      "stop": false,
14
      "condition": { "cart": { "minimum_spend": 100 } }
15
    }
16
  ],
17
  "notifications": [],
18
  "stop": false,
19
  "status": "ENABLED",
20
  "currency_code": "USD",
21
  "start_date": "2025-10-01T00:00:00-05:00",
22
  "end_date": null
23
}

1
{
2
  "can_be_used_with_other_promotions": true,
3
  "channels": [],
4
  "coupon_overrides_automatic_when_offering_higher_discounts": false,
5
  "currency_code": "USD",
6
  "current_uses": 0,
7
  "created_from": "api",
8
  "customer": {
9
    "group_ids": [],
10
    "minimum_order_count": 0,
11
    "segments": null,
12
    "excluded_group_ids": []
13
  },
14
  "end_date": null,
15
  "max_uses": null,
16
  "name": "discount on shipping - percent",
17
  "notifications": [],
18
  "redemption_type": "AUTOMATIC",
19
  "rules": [
20
    {
21
      "action": {
22
      "shipping_discount": {
23
        "discount": {
24
          "percentage_amount": "10",
25
        },
26
        "maximum_allowed_discount_amount": "15",
27
        "method_ids": "*"
28
      }
29
    },
30
    "apply_once": true,
31
    "stop": false
32
    }
33
  ],
34
  "schedule": null,
35
  "shipping_address": null,
36
  "start_date": "2025-10-15T00:00:00-05:00",
37
  "status": "ENABLED",
38
  "display_name": "Get 10% off on shipping upto $15"
39
}