Create or Update Link (ARM)

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

Creates a new or updates an existing Link in a Customer Insights Hub.


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
hubName Yes Name of your Customer Insights Hub
linkName Yes The name of the link to create or update.

Request Body

A JSON object describing a Link, for example:

    "linkName": "linkTest4806",
    "sourceInteractionType": "testInteraction1949",
    "targetProfileType": "testProfile1446",
    "displayName": {
        "en-us": "Link DisplayName"
    "description": {
        "en-us": "Link Description"
    "mappings": [{
        "interactionTypePropertyName": "testInteraction1949",
        "profileTypePropertyName": "testProfile1446",
        "isProfileTypeId": true,
        "linkType": "UpdateAlways"
    "participantPropertyReferences": [{
        "interactionPropertyName": "testInteraction1949",
        "profilePropertyName": "ProfileId"


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 link in the following form:

    "id": <linkUrl>, 
    "name": <linkName>, 
    "type": "Microsoft.CustomerInsights/hubs/links", 
    "properties": { <linkProperties> }

Status Code

  • 200 (OK) - the update request completed successfully. The provisioningState property in the response body is set to 'Succeeded' when the link provisioning finishes.
  • 201 (Created) - if the create request completed successfully.
  • 400 (Bad Request) – link definition validation failed.