---
title: "Criar ou atualizar regras de frete grátis"
method: POST
path: "/{alias}/pricing/free-shipment"
tags: ["Promoções - Frete grátis"]
---

# Criar ou atualizar regras de frete grátis

`POST /{alias}/pricing/free-shipment`

Cria ou atualiza regras de frete grátis

## Path parameters

- `alias` string, required

## Request body

- FreeShipmentRequest
  - `rules` object[], required
    - `shipment_service_id` integer, required
    - `service_name` string
    - `min` number, float, required
    - `uf` string, required
  - `exclude_brands_ids` integer[]
  - `exclude_categories_ids` integer[]
  - `exclude_products_ids` integer[]

## Response `200`

Regras de frete grátis criadas ou atualizadas com sucesso

- FreeShipment
  - `id` integer
  - `shipment_service_id` integer
  - `uf` string
  - `min` number, float
  - `service_name` string

## Other responses

- `400` — Requisição inválida

---

[API](https://skmtc.net/yampi/apis/yampi-api.md) · [All operations](https://skmtc.net/yampi/apis/yampi-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/yampi/yampi-api/revisions/fa16c50bef09/schema)