externalConnection resource type

Namespace: microsoft.graph.externalConnectors

A logical container to add content from an external source into Microsoft Graph.

Methods

Method Return type Description
Create externalConnection externalConnection Create a new externalConnection object.
List externalConnections externalConnection collection Get a list of the externalConnection objects and their properties.
Get externalConnection externalConnection Read the properties and relationships of an externalConnection object.
Update externalConnection externalConnection Update the properties of an externalConnection object.
Delete externalConnection None Deletes an externalConnection object.
Create schema schema Create a new schema object.
Create externalItem externalItem Create a new externalItem object.

Properties

Property Type Description
activitySettings microsoft.graph.externalConnectors.activitySettings Collects configurable settings related to activities involving connector content.
configuration microsoft.graph.externalConnectors.configuration Specifies additional application IDs that are allowed to manage the connection and to index content in the connection. Optional.
connectorId String The Teams app ID. Optional.
description String Description of the connection displayed in the Microsoft 365 admin center. Optional.
id String Developer-provided unique ID of the connection within the Microsoft Entra tenant. Must be between 3 and 32 characters in length. Must only contain alphanumeric characters. Cannot begin with Microsoft or be one of the following values: None, Directory, Exchange, ExchangeArchive, LinkedIn, Mailbox, OneDriveBusiness, SharePoint, Teams, Yammer, Connectors, TaskFabric, PowerBI, Assistant, TopicEngine, MSFT_All_Connectors. Required.
name String The display name of the connection to be displayed in the Microsoft 365 admin center. Maximum length of 128 characters. Required.
searchSettings microsoft.graph.externalConnectors.searchSettings The settings configuring the search experience for content in this connection, such as the display templates for search results.
state microsoft.graph.externalConnectors.connectionState Indicates the current state of the connection. Possible values are: draft, ready, obsolete, limitExceeded, unknownFutureValue.

Relationships

Relationship Type Description
items microsoft.graph.externalConnectors.externalItem collection Read-only. Nullable.
operations microsoft.graph.externalConnectors.connectionOperation collection Read-only. Nullable.
schema microsoft.graph.externalConnectors.schema Read-only. Nullable.

JSON representation

The following JSON representation shows the resource type.

{
  "activitySettings": {
    "@odata.type": "microsoft.graph.externalConnectors.activitySettings"
  },
  "configuration": {
    "@odata.type": "microsoft.graph.externalConnectors.configuration"
  },
  "connectorId": "String",
  "description": "String",
  "id": "String (identifier)",
  "name": "String",
  "searchSettings": {
    "@odata.type": "microsoft.graph.externalConnectors.searchSettings"
  },
  "state": "String"
}