Promocode Pools Bulk Import

Method Description

Invoked with a POST request. Request address is set up via Maestra framework.

POST https://api.maestra.io/v3/operations/bulk?endpointId={API endpoint ID}&operation=DirectCrm.PromoCodeTypes.Import&csvCodePage=65001&folderSystemName={internal folder name}
HTTP/1.1

Authorization: SecretKey {Secret Key}
Accept: application/xml
Content-Type: text/csv

• csvCodePage: Windows codepage ID for CSV file. 65001 (UTF-8) is preferred.
• csvColumnDelimiter: Column delimiter symbol in CSV file.
• folderSystemName: Internal name of the folder, where the promo codes are added
• csvTextQualifier: Optional start/end character in column value, masking otherwise invalid characters.
• Authorization key: The value is obtained via Maestra.
• The service allows up to 60 imports per hour. When this limit is exceeded, you’ll receive 429 Too Many Requests until the ratio of tasks queued/hour drops below 60.

Field Descriptions

Sample Request

POST https://api.maestra.io/v3/operations/bulk?endpointId=Maestra&operation=DirectCrm.PromoCodeTypes.Import&csvCodePage=65001&folderSystemName=Registration

Authorization: SecretKey VRY294
Accept: application/xml
Content-Type: text/csv


ExternalId;Name;IssueStartDateTimeUtc;IssueEndDateTimeUtc
1;New promo code pool;2017-11-11 13:30:00;2017-12-11 13:30:00