---
title: "GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomerInsights/hubs/{hubName}/links"
method: GET
path: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomerInsights/hubs/{hubName}/links"
tags: ["Links"]
---

# GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomerInsights/hubs/{hubName}/links

`GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomerInsights/hubs/{hubName}/links`

## Request

- Base URL: `https://management.azure.com`
- URL: `https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomerInsights/hubs/{hubName}/links`
- Auth: OAuth 2
  - Implicit: `https://login.microsoftonline.com/common/oauth2/authorize`
  - Scopes: `user_impersonation`

Gets all the links in the specified hub.

## Path parameters

- `resourceGroupName` string, required
- `hubName` string, required
- `subscriptionId` string, required

## Query parameters

- `api-version` string, required

## Response `200`

OK. Successfully get all the links in the hub.

- LinkListResult: The response of list link operation.
  - `value` LinkResourceFormat[]: Results of the list operation.
    - `id` string: Resource ID.
    - `name` string: Resource name.
    - `type` string: Resource type.
    - `properties` LinkDefinition: The definition of Link.
      - `tenantId` string: The hub name.
      - `linkName` string: The link name.
      - `sourceInteractionType` string, required: Name of the source Interaction Type.
      - `targetProfileType` string, required: Name of the target Profile Type.
      - `displayName` object: Localized display name for the Link.
      - `description` object: Localized descriptions for the Link.
      - `mappings` TypePropertiesMapping[]: The set of properties mappings between the source and target Types.
        - `interactionTypePropertyName` string, required: Property name on the source Interaction Type.
        - `profileTypePropertyName` string, required: Property name on the target Profile Type.
        - `isProfileTypeId` boolean: Flag to indicate whether the Profile Type property is an id on the Profile Type.
        - `linkType` 'UpdateAlways' | 'CopyIfNull': Link type.
      - `participantPropertyReferences` ParticipantPropertyReference[], required: The properties that represent the participating profile.
        - `interactionPropertyName` string, required: The interaction property that maps to the profile property.
        - `profilePropertyName` string, required: The profile property that maps to the interaction property.
      - `provisioningState` 'Provisioning' | 'Succeeded' | 'Expiring' | 'Deleting' | 'HumanIntervention' | 'Failed': Provisioning state.
      - `referenceOnly` boolean: Indicating whether the link is reference only link. This flag is ignored if the Mappings are defined. If the mappings are not defined and it is set to true, links processing will not create or update profiles.
      - `operationType` 'Upsert' | 'Delete': Determines whether this link is supposed to create or delete instances if Link is NOT Reference Only.
  - `nextLink` string: Link to the next set of results.

---

[API](https://skmtc.dev/azure/apis/customer-insights-microsoft-customerinsights-customerinsight.md) - [All operations](https://skmtc.dev/azure/apis/customer-insights-microsoft-customerinsights-customerinsight/llms.txt) - [OpenAPI document](https://skmtc.dev/azure/apis/customer-insights-microsoft-customerinsights-customerinsight/revisions/1a3e19f598e0?raw)
