Channels 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.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;Updated about 1 year ago

