# Set up "Free shipping" promotions

You can offer free shipping to customers through automatic promotions or discount coupons for promos like **Free delivery weekend**.

{% hint style="info" %}
If you don't yet have an app for Ecwid API access, start with the following [instructions](https://app.gitbook.com/s/uOzT5egoVTAjMJwRuMQT/get-started/set-up-your-dev-environment-in-ecwid#step-2.-get-your-first-application).
{% endhint %}

### Discounted shipping through promotion

Request example for a new promotion: "**50% Off for DHL delivery**"

```http
POST /api/v3/STOREID/promotions
Host: app.ecwid.com
Content-Type: application/json
Authorization: Bearer secret_token

{
    "name": "50% Off for DHL delivery",
    "discountBase": "SHIPPING",
    "discountType": "PERCENT",
    "amount": 50,
    "enabled": true,
    "targets": {
        "shippingMethods": ["6589-1709547151586"]
    }
}
```

where:

```json
    "discountBase": "SHIPPING",
    "discountType": "PERCENT",
    "amount": 50
```

sets up a 50% discount that only applies to the shipping cost, and `shippingMethods` array limits the discount by specific shipping method IDs.

Change `STOREID` with your store ID and the `secret_token` with the secret access token of your app.

### Free shipping through coupon

Request example for a new discount coupon: "**Free DHL delivery**"

```http
POST /api/v3/STOREID/discount_coupons
Host: app.ecwid.com
Content-Type: application/json
Authorization: Bearer secret_token

{
    "name": "Free DHL delivery",
    "code": "DHL_FREE"
    "discountType": "SHIPPING",
    "status": "ACTIVE",
    "shippingLimit": {
        "shippingMethods": ["6589-1709547151586"]
    }
}
```

where: `"discountType": "SHIPPING"` defines free shipping, and the `shippingMethods` array limits the discount to specific shipping method IDs.

Change `STOREID` with your store ID and the `secret_token` with the secret access token of your app.