Bulk Adding Products to List

Method Description

Invoked with a POST request. The service adds new products to existing product list. Request address and input fields can be set up via Maestra framework.

POST https://api.maestra.io/v3/operations/bulk?endpointId={API endpoint ID}&operation=DirectCrm.AddToPersonalProductList&brand{brand}&pointOfContact={point of contact}&personalProductListSystemName={internal name of product list}&productAddedActionTemplateSystemName={action of adding a product to product list}&productRemovedActionTemplateSystemName={action of removing a product from product list}&csvCodePage=65001&csvColumnDelimiter=%3B&csvTextQualifier=%22

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.
csvTextQualifier: Optional start/end character in column value, masking otherwise invalid characters.
brand: Brand which the customers belong to. Value can be retrieved via Maestra framework.
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

Title	Description
CustomerWebsiteid	Customer website ID
ProductWebsiteid	Product website ID
Quantity	Quantity

Sample Request

POST https://api.maestra.io/v3/operations/bulk?endpointId=Maestra&peration=DirectCrm.AddToPersonalProductList&brand=Maestra&pointOfContact=website&personalProductListSystemName=LyubimyeTovary&productAddedActionTemplateSystemName=DobavlenieTovaraPriUstanovkeSostava&productRemovedActionTemplateSystemName=UdalenieTovaraIzLyubimye&csvCodePage=65001&csvColumnDelimiter=%3B&csvTextQualifier=%22

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



CustomerWebsiteid;ProductWebsiteid;Quantity
21324;268;1
21324;270;1
21324;1574;1