Create or Update Data Connector Mapping (ARM)

[This topic is pre-release documentation and is subject to change.]

Creates a new or updates an existing Connector Mapping.


The request is constructed as follows:

HTTP Verb Request URI

URI Parameters

URI Parameter Required Description
subId Yes The Azure subscription ID
rgName Yes The resource group name
mappingName Yes The name of the connector mapping to create or update

Request Body

A JSON object describing a ConnectorMapping mapping, for example:

    "entityType": "Interaction",
    "entityTypeName": "TestInteractionType2967",
    "displayName": "testMapping12491",
    "description": "Test mapping",
    "mappingProperties": {
        "folderPath": "",
        "fileFilter": "unknown",
        "hasHeader": false,
        "errorManagement": {
            "errorManagementType": "StopImport",
            "errorLimit": 10
        "format": {
            "formatType": "TextFormat",
            "columnDelimiter": "|"
        "availability": {
            "frequency": "Hour",
            "interval": 5
        "structure": [{
            "propertyName": "prop1",
            "columnName": "col1",
            "isEncrypted": false
            "propertyName": "prop2",
            "columnName": "col2",
            "isEncrypted": true
        "completeOperation": {
        "completionOperationType": "DeleteFile",
        "destinationFolder": "Path1"


The response includes an HTTP status code and a standard set of response headers. Upon success, the body will contain information about the newly created mapping in the following form:

    "id": <mappingUrl>, 
    "name": <mappingName>, 
    "type": "Microsoft.CustomerInsights/hubs/mappings", 
    "properties": { <mappingProperties> }

Status Code

  • 200 (OK) - the update request completed successfully.
  • 201 (Created) - the create request completed successfully.
  • 401 (Unauthorized) - the sender does not have write access to this resource.