Skip to main content

Voyado Engage

Update a promotion

Drafts can be updated but Active promotions can’t. It is possible to update the entire promotion or only the validity. The two functions have different API endpoints which are described below.

Update the entire promotion

Update an existing multichannel promotion.

Endpoint/api/v2/promotions/multichannels/{id}

{
  "id": "24138ab3-0421-4688-a4b0-40a3c410fa4f",
  "status": "Draft",
  "externalId": "externalIdentifier",
  "name": "Promotion Name",
  "validity": {
    "startDate": "2019-10-15T11:18:50.5258317+02:00",
    "assignedValidity": {
      "unit": "Months",
      "amount": 3
    }
  },
  "presentation": {
    "heading": "Promotion presentation title",
    "description": "Promotion presentation description",
    "link": "http://www.example.com"
  },
  "redemptionChannels": [
    {
      "type": "POS",
      "valueType": "EXTERNALOFFER",
      "value": "PromotionCode123",
    },
    {
      "type": "ECOM",
      "valueType": "EXTERNALOFFER",
      "value": "PromotionCode123"
    }
  ]
}

Update the validity

Updates the duration of an existing multichannel promotion.

Endpoint: /api/v2/promotions/multichannels/{id}

{
  "startDate": "2019-10-14T09:18:50.885+01:00",
  "endDate": "2021-10-14T09:18:50.885+01:00",
  "assignedValidity": {
    "unit": "Months",
    "amount": 4
  }
}