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
Updated about 1 month ago