--- title: "Create ecommerce coupon" method: POST path: "/ecommerce/coupons" --- # Create ecommerce coupon `POST /ecommerce/coupons` ## Request - Base URL: `https://api.service.getjusto.com/v3` - URL: `https://api.service.getjusto.com/v3/ecommerce/coupons` - Auth: none declared Crea un cupón ecommerce para la marca autorizada. Si se envía code, se crea también un primer código asociado. ## Request body - object - `coupon` ApiCouponInput, required: Campos para crear o actualizar un cupón ecommerce. - `code` string: Código inicial opcional para crear junto al cupón. - `name` string, required: Nombre visible del cupón. - `description` string, required: Descripción interna o visible del beneficio. - `type` 'percentage' | 'percentageOnDiscount' | 'fixed' | 'fixedOnDelivery' | 'fixedItemPrice', required: Tipo de descuento. - `active` boolean, required: Indica si el cupón queda activo. - `percentageOff` number: Porcentaje de descuento para cupones porcentuales. - `maxPercentageOffDiscount` number: Tope de descuento para cupones porcentuales. - `discountAmount` number: Monto fijo de descuento. - `fixedAmount` number: Precio fijo aplicado a productos seleccionados. - `fromDate` string, date-time: Fecha desde la que el cupón puede usarse. - `endDate` string, date-time: Fecha hasta la que el cupón puede usarse. - `maxRedemptions` number: Cantidad máxima de canjes totales. - `maxRedemptionsPerUser` number: Cantidad máxima de canjes por usuario. - `maxRedemptionsPerUserPerDay` boolean: Si es true, permite máximo un canje diario. - `maxRedemptionsPerCode` number: Cantidad máxima de canjes por código. - `onlyForNewUsers` boolean: Si es true, aplica solo a usuarios nuevos. - `onlyForProductsWithoutDiscount` boolean: Si es true, no aplica sobre productos con descuento. - `requirePhoneVerification` boolean: Si es true, exige teléfono verificado. - `requiresCategoriesIds` string[]: Categorías requeridas para aplicar el cupón. - `requiresProductsIds` string[]: Productos requeridos para aplicar el cupón. - `requiresStoresIds` string[]: Locales donde puede usarse el cupón. - `requiresMenusIds` string[]: Menús donde puede usarse el cupón. - `requiresPaymentTypes` string[]: Medios de pago requeridos. - `requireChannels` string[]: Canales requeridos para usar el cupón. - `requiredBINs` string[]: BINs de tarjeta admitidos. - `minimumOrderPrice` number: Monto mínimo del pedido. - `maximumOrderPrice` number: Monto máximo del pedido. - `dontApplyToProductsIds` string[]: Productos excluidos del descuento. - `dontApplyDiscountToOptions` boolean: Si es true, no aplica descuento sobre opciones/modificadores. - `isHidden` boolean: Si es true, oculta el cupón de listados públicos. - `allowedEmails` string[]: Emails autorizados para usar el cupón. - `externalId` string: Identificador externo del cupón. - `isBirthdayCoupon` boolean: Si es true, es un cupón de cumpleaños. - `onlyRedeemOnBirthday` boolean: Si es true, solo se canjea el día del cumpleaños. - `autoRecommend` boolean: Si es true, Justo puede recomendarlo automáticamente. - `applyDeliveryDiscount` boolean: Si es true, aplica descuento al despacho. - `deliveryDiscountValue` number: Valor del descuento de despacho. - `deliveryDiscountType` string: Tipo de descuento de despacho. - `deliveryDiscountPercentage` number: Porcentaje de descuento de despacho. - `maxProductsPerOrder` number: Máximo de productos a los que se aplica el cupón. ## Response `200` The OpenAPI spec - object - `success` boolean - `data` ApiCoupon: Cupón ecommerce de la marca autorizada. La data siempre queda limitada al website autorizado. - `_id` string: ID Justo del cupón. - `websiteId` string: ID de la marca dueña del cupón. - `code` string: Primer código activo asociado al cupón, si existe. - `name` string: Nombre visible del cupón. - `description` string: Descripción interna o visible del beneficio. - `type` 'percentage' | 'percentageOnDiscount' | 'fixed' | 'fixedOnDelivery' | 'fixedItemPrice': Tipo de descuento. - `active` boolean: Indica si el cupón está activo. - `percentageOff` number: Porcentaje de descuento para cupones porcentuales. - `maxPercentageOffDiscount` number: Tope de descuento para cupones porcentuales. - `discountAmount` number: Monto fijo de descuento. - `fixedAmount` number: Precio fijo aplicado a productos seleccionados. - `fromDate` string, date-time: Fecha desde la que el cupón puede usarse. - `endDate` string, date-time: Fecha hasta la que el cupón puede usarse. - `maxRedemptions` number: Cantidad máxima de canjes totales. - `maxRedemptionsPerUser` number: Cantidad máxima de canjes por usuario. - `maxRedemptionsPerUserPerDay` boolean: Si es true, permite máximo un canje diario. - `maxRedemptionsPerCode` number: Cantidad máxima de canjes por código. - `totalRedemptions` number: Cantidad total de canjes realizados. - `onlyForNewUsers` boolean: Si es true, aplica solo a usuarios nuevos. - `onlyForProductsWithoutDiscount` boolean: Si es true, no aplica sobre productos con descuento. - `requirePhoneVerification` boolean: Si es true, exige teléfono verificado. - `requiresCategoriesIds` string[]: Categorías requeridas para aplicar el cupón. - `requiresProductsIds` string[]: Productos requeridos para aplicar el cupón. - `requiresStoresIds` string[]: Locales donde puede usarse el cupón. - `requiresMenusIds` string[]: Menús donde puede usarse el cupón. - `requiresPaymentTypes` string[]: Medios de pago requeridos. - `requireChannels` string[]: Canales requeridos para usar el cupón. - `requiredBINs` string[]: BINs de tarjeta admitidos. - `minimumOrderPrice` number: Monto mínimo del pedido. - `maximumOrderPrice` number: Monto máximo del pedido. - `dontApplyToProductsIds` string[]: Productos excluidos del descuento. - `dontApplyDiscountToOptions` boolean: Si es true, no aplica descuento sobre opciones/modificadores. - `isHidden` boolean: Si es true, oculta el cupón de listados públicos. - `allowedEmails` string[]: Emails autorizados para usar el cupón. - `externalId` string: Identificador externo del cupón. - `isBirthdayCoupon` boolean: Si es true, es un cupón de cumpleaños. - `onlyRedeemOnBirthday` boolean: Si es true, solo se canjea el día del cumpleaños. - `autoRecommend` boolean: Si es true, Justo puede recomendarlo automáticamente. - `applyDeliveryDiscount` boolean: Si es true, aplica descuento al despacho. - `deliveryDiscountValue` number: Valor del descuento de despacho. - `deliveryDiscountType` string: Tipo de descuento de despacho. - `deliveryDiscountPercentage` number: Porcentaje de descuento de despacho. - `maxProductsPerOrder` number: Máximo de productos a los que se aplica el cupón. - `createdAt` string, date-time: Fecha de creación. - `deletedAt` string, date-time: Fecha de eliminación lógica. ## Other responses - `400`: Errors ## Changes - **2026-06-02** `dd70866e9669`: 1 info - endpoint added [Operation history](https://skmtc.dev/getjusto/apis/justo-api/changes/ecommerce/coupons/post.md) --- [API](https://skmtc.dev/getjusto/apis/justo-api.md) - [All operations](https://skmtc.dev/getjusto/apis/justo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getjusto/apis/justo-api/revisions/c810bd8246fd?raw)