curl --request POST \
  --url https://{host}/promotion/v3/bulk/offers \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json-patch+json' \
  --data '
[
  {
    "offerId": "0b72aaa9-a868-46fe-b3d8-1f33356f6df3",
    "name": "coca_cola_10p_off",
    "validFrom": "2026-08-09T00:00:00Z",
    "validTo": "2026-08-15T00:00:00Z",
    "previewVisibleFrom": null,
    "offerType": "appCoupon",
    "unifiedCampaignId": null,
    "title": null,
    "description": null,
    "brand": null,
    "imageUrl": null,
    "discountLabel": null,
    "normalPriceLabel": null,
    "pricePerUnitLabelEnabled": null,
    "unitOfMeasure": null,
    "conditionLabel": null,
    "receiptDisplayText": null,
    "tags": null,
    "normalPrice": 5,
    "normalPricePerUnit": 10,
    "currency": "EUR",
    "priority": 5,
    "allowOtherDiscountsOnTop": false,
    "itemsApplicationType": "NonDiscountedItems",
    "maxDiscountAmount": 5,
    "impactLevel": "Line",
    "discountType": "SimpleLine",
    "applyOnHighestPrice": false,
    "maxNumberApplyPerReceipt": 1,
    "redemptionLimit": 1,
    "checkoutTypes": null,
    "rewardRedeemableFrom": null,
    "rewardRedeemableTo": null,
    "rewardRedeemableForDays": null,
    "totalCoupons": null,
    "isDefault": false,
    "chainIds": "1",
    "storeIds": null,
    "audienceIds": null,
    "fundedBy": null,
    "displayPriority": null,
    "preactivated": null,
    "ignoreOnPos": null,
    "published": false,
    "defaultValidForDays": null,
    "rule1Type": "percentage",
    "rule1Value": 0.1,
    "rule1ThresholdType": "quantity",
    "rule1ThresholdValue": 1,
    "rule1IncludedProducts": "coca-cola;fanta",
    "rule1ExcludedProducts": "",
    "rule1IncludedCategories": "",
    "rule1ExcludedCategories": ""
  }
]
'

{
  "errors": [
    {
      "name": "<string>",
      "message": "<string>",
      "details": null
    }
  ]
}

{
  "errors": [
    {
      "name": "<string>",
      "message": "<string>",
      "details": null
    }
  ]
}

{
  "name": "<string>",
  "message": "<string>",
  "details": null
}

Import Offers

Format compatible with Data Import.

If Offer does not exist, it will be created. If Offer already exists, it is updated in place. If import of one Offer fails, it is ignored and others Offers are processed.

Empty string will clear the field. Null value will leave the field unchanged.

WARNING: when using Data Import, fields are updated to the values from the file, any existing values will be overwritten. If numerical values are not provided, default values will be used instead.

At least one discount rule is required to publish an Offer. If you send offer with Published = true, but without rules, offer will not be created.

Requests should follow the schema: Be aware, putting a decimal value into an integer field (or providing an incorrect enum value) will cause an error that will prevent any Offer from being inserted due to parsing errors.

Multiple discount rules can be inserted for each offer. Use rule2Value, rule2Type, etc for all following rules. Rules need to come in order, you cannot have rule 1 and rule 4, it needs to be rule 1 then rule 2, then rule 3 and so on. Rules not in order will be ignored.

POST

bulk

offers

curl --request POST \
  --url https://{host}/promotion/v3/bulk/offers \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json-patch+json' \
  --data '
[
  {
    "offerId": "0b72aaa9-a868-46fe-b3d8-1f33356f6df3",
    "name": "coca_cola_10p_off",
    "validFrom": "2026-08-09T00:00:00Z",
    "validTo": "2026-08-15T00:00:00Z",
    "previewVisibleFrom": null,
    "offerType": "appCoupon",
    "unifiedCampaignId": null,
    "title": null,
    "description": null,
    "brand": null,
    "imageUrl": null,
    "discountLabel": null,
    "normalPriceLabel": null,
    "pricePerUnitLabelEnabled": null,
    "unitOfMeasure": null,
    "conditionLabel": null,
    "receiptDisplayText": null,
    "tags": null,
    "normalPrice": 5,
    "normalPricePerUnit": 10,
    "currency": "EUR",
    "priority": 5,
    "allowOtherDiscountsOnTop": false,
    "itemsApplicationType": "NonDiscountedItems",
    "maxDiscountAmount": 5,
    "impactLevel": "Line",
    "discountType": "SimpleLine",
    "applyOnHighestPrice": false,
    "maxNumberApplyPerReceipt": 1,
    "redemptionLimit": 1,
    "checkoutTypes": null,
    "rewardRedeemableFrom": null,
    "rewardRedeemableTo": null,
    "rewardRedeemableForDays": null,
    "totalCoupons": null,
    "isDefault": false,
    "chainIds": "1",
    "storeIds": null,
    "audienceIds": null,
    "fundedBy": null,
    "displayPriority": null,
    "preactivated": null,
    "ignoreOnPos": null,
    "published": false,
    "defaultValidForDays": null,
    "rule1Type": "percentage",
    "rule1Value": 0.1,
    "rule1ThresholdType": "quantity",
    "rule1ThresholdValue": 1,
    "rule1IncludedProducts": "coca-cola;fanta",
    "rule1ExcludedProducts": "",
    "rule1IncludedCategories": "",
    "rule1ExcludedCategories": ""
  }
]
'

{
  "errors": [
    {
      "name": "<string>",
      "message": "<string>",
      "details": null
    }
  ]
}

{
  "errors": [
    {
      "name": "<string>",
      "message": "<string>",
      "details": null
    }
  ]
}

{
  "name": "<string>",
  "message": "<string>",
  "details": null
}

Authorizations

Authorization

string

header

required

Opaque Authorization header using the Bearer scheme. Example: "Authorization: Bearer {token}"

Body

The list of offers to import.

offerId

string

required

ID of the offer.

Minimum string length: 1

name

string | null

Name of the offer visible in the admin tools.

validFrom

string<date-time> | null

Date when any coupons for this offer become available to pick up in store.

validTo

string<date-time> | null

Date when all coupons for this offer stop being available to pick up in the store.

previewVisibleFrom

string<date-time> | null

Date when Coupons will be returned in API and visible in the app. Cannot be cleared after being set.

offerType

string | null

Customer specific offer type. Determines how or by which service offer will be used. Types used so far: game, appCoupon, gift, preferredStore, memberOffer, stampCard, stickersCampaign, segmentedAppCoupon, personalOffer. If not specified and offer is new, default type will be used, but publish will fail.

unifiedCampaignId

string | null

ID of the unified campaign to which offer belongs.

Maximum string length: 64

title

string | null

Title of product visible in mobile app and in the coupon list. Can be cleared by passing empty string.

Maximum string length: 255

description

string | null

Additional description of product visible in mobile app. Can be cleared by passing empty string.

brand

string | null

Brand of product. Can be cleared by passing empty string.

Maximum string length: 50

imageUrl

string | null

Url to the image which be displayed in the promotion in the app. Can be cleared by passing empty string.

Maximum string length: 2000

discountLabel

string | null

Discount label - for example Price For a Day or Monthly Price. Can be cleared by passing empty string.

Maximum string length: 255

normalPriceLabel

string | null

Normal price label - for example Non-member Price. Can be cleared by passing empty string.

Maximum string length: 255

pricePerUnitLabelEnabled

boolean | null

Is the price per unit of the product(per kilo, per bottle, etc) visible in the mobile app

unitOfMeasure

string | null

Unit of measure for the product - EA, kg, etc... Can be cleared by passing empty string.

Maximum string length: 255

conditionLabel

string | null

Condition label used for override default condition label in the app

Maximum string length: 64

receiptDisplayText

string | null

Text that should be printed on receipt when the offer is applied

Maximum string length: 100

Response

errors

object[] | null

Show child attributes

Last modified on August 10, 2026

⌘I