Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Manage offers (synchronous API)

Create an offer

post

Creates a new offer.

Authorizations
AuthorizationstringRequired

For system access use case, use API key/secret in the Authorization header, the API key should be set up with sufficient role.

Header parameters
x-siteIdstringRequired

The site ID associated with the offer.

Body
namestringRequired

Name of an offer.

Example: Offer_New_1
descriptionstringOptional

A description of the offer.

Example: Offer_New_1
externalReferenceOfferIdstringOptional

The external reference identifier of the offer.

Example: Offer_New_1
offerTypestringRequired

Type of the offer.

Example: discount
offerTriggerstringRequired

Determines how the offer is triggered. Possible values are promotionalUrlOrExternalTriggered, alwaysTriggered, couponCode, siteTest.

Example: promotionalUrlOrExternalTriggered
couponTypestringRequired

Type of the added coupon. If offerTrigger is couponCode then couponType field is required. Possible values are importCouponCodes, enterCouponCodes, generateCouponCodes, rangeCouponCodes.

Example: importCouponCodes
offerStartDatestringOptional

Start date of an offer.

Example: 2024-05-12T00:00:00.000Z
offerEndDatestringOptional

End date of an offer.

Example: 2024-05-13T00:00:00.000Z
totalUsageLimitnumberOptional

Total usuage limit of an offer.

Example: 18
shopperUsageLimitnumberOptional

Shopper usage limit of an offer.

Example: 12
catalogIdstringOptional

The catalog associated to the offer.

Example: 823600
currencystringRequired

The currency of an offer. It is required only when we have product’s discountType either 'Amount' or 'Amount Off'.

Example: USD
priceListTypestringOptional

The price list of the offer.

Example: listPrice
Responses
201

Offer successfully created.

application/json
idstringOptional

Identifier of an offer..

Example: 426368220289
statusstringOptional

Status of an offer.

Example: Draft
namestringOptional

The name of the offer.

Example: Key_New_315511
descriptionstringOptional

Description of an offer.

Example: New_Release_Offer_5
externalReferenceOfferIdstringOptional

The external reference identifier of the offer.

Example: Key_New_315511
siteIdstringOptional

The site ID associated with the offer.

Example: paytest2
offerTypestringOptional

The type of the offer.

Example: discount
offerTriggerstringOptional

Determines how the offer is triggered. Possible values are alwaysTriggered, couponCode, siteTest.

Example: promotionalUrlOrExternalTriggered
offerStartDatestringOptional

Start date of an offer.

Example: 2024-05-12T00:00:00.000Z
offerEndDatestringOptional

End date of an offer. End date must be a future date.

Example: 2024-05-13T00:00:00.000Z
creationDatestringOptional

The date of creation of an offer.

Example: 2024-05-02T08:29:00.275Z
modificationDatestringOptional

The date of modification of an offer.

Example: 2024-05-02T08:29:00.275Z
defaultLocalestringOptional

Default locale of an offer.

Example: en_US
totalUsageLimitnumberOptional

Total usuage limit of an offer.

Example: 1
shopperUsageLimitnumberOptional

Shopper usage limit of an offer.

Example: 1
catalogIdstringOptional

The catalog associated to the offer.

Example: 823600
currencystringOptional

The currency of an offer.

Example: USD
priceListTypestringOptional

The price list of an offer.

Example: listPrice
post/v1/offers
POST /v1/offers HTTP/1.1
Host: api.digitalriver.com
Authorization: Basic username:password
x-siteId: text
Content-Type: application/json
Accept: */*
Content-Length: 508

{
  "name": "Offer_New_1",
  "description": "Offer_New_1",
  "externalReferenceOfferId": "Offer_New_1",
  "offerType": "discount",
  "offerTrigger": "promotionalUrlOrExternalTriggered",
  "couponType": "importCouponCodes",
  "offerStartDate": "2024-05-12T00:00:00.000Z",
  "offerEndDate": "2024-05-13T00:00:00.000Z",
  "supportedLocales": [
    {
      "locale": "en_GB"
    }
  ],
  "totalUsageLimit": 18,
  "shopperUsageLimit": 12,
  "catalogId": "823600",
  "currency": "USD",
  "priceListType": "listPrice",
  "products": [
    {
      "id": "287656800",
      "discountType": "Amount",
      "discountValue": 2
    }
  ]
}
{
  "id": "426368220289",
  "status": "Draft",
  "name": "Key_New_315511",
  "description": "New_Release_Offer_5",
  "externalReferenceOfferId": "Key_New_315511",
  "siteId": "paytest2",
  "offerType": "discount",
  "offerTrigger": "promotionalUrlOrExternalTriggered",
  "offerStartDate": "2024-05-12T00:00:00.000Z",
  "offerEndDate": "2024-05-13T00:00:00.000Z",
  "creationDate": "2024-05-02T08:29:00.275Z",
  "modificationDate": "2024-05-02T08:29:00.275Z",
  "defaultLocale": "en_US",
  "supportedLocales": [
    {
      "locale": "en_CA"
    }
  ],
  "totalUsageLimit": 1,
  "shopperUsageLimit": 1,
  "catalogId": "823600",
  "currency": "USD",
  "priceListType": "listPrice",
  "products": [
    {
      "id": "287656800",
      "discountType": "Amount",
      "discountValue": 2
    }
  ]
}

Last updated