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