Create a promotion
You can create a draft version of a promotion via the Engage API. The activation of this promotion, and assigning it to a specific contact, must be manually done in Engage.
Create a draft promotion with the following endpoint:
POST /api/v2/promotions/multichannels
Request example
{ "externalId": "externalIdentifier", "name": "Promotion Name", "validity": { "startDate": "2020-11-18T13:45:42.3990357+01: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": "POS-CAMPAIGN-123", "instruction": "POS Instruction" }, { "type": "ECOM", "valueType": "EXTERNALOFFER", "value": "ECOM-CAMPAIGN-1337" } ] }
Response example
{ "id": "9125f018-1838-4f65-929d-87f0b4353661", "status": "Draft", "externalId": "externalIdentifier", "name": "Promotion Name", "validity": { "startDate": "2019-06-14T10:43:20.4688587+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": "POS-CAMPAIGN-123" }, { "type": "ECOM", "valueType": "EXTERNALOFFER", "value": "ECOM-CAMPAIGN-1337" } ] }
Response codes
If the request has been successful, you'll get a HTTP 200 OK response. Otherwise you'll get one of these:
400: BadRequest
500: Error