Bulk Import of Channels

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.Channels.Import&csvCodePage=65001
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.
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
ExternalId	Channel ID For example, "15"
Name	Channel ID. For example, "Austin"
Comment	Channel description
ParentChannelExternalId	Parent channel ID. Parent channels are used to establish an hierarchy, for example region > city > store.

Sample Request

POST https://api.maestra.io/v3/operations/bulk?endpointId=Maestra&operation=DirectCrm.Channels.Import&suppressAllWarnings=true&csvCodePage=65001&csvColumnDelimiter=%3B&csvTextQualifier=%22

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


ExternalId;Name;Comment;ParentChannelExternalId
15;Austin;-;1
1;TX;