externalConnection resource type

Namespace: microsoft.graph.externalConnectors


APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

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


Method Return Type Description
Create externalConnection externalConnection Create a new externalConnection by posting to the connections collection.
List externalConnections externalConnection collection Get a externalConnection object collection.
Get externalConnection externalConnection Read properties and relationships of a externalConnection object.
Update externalConnection externalConnection Update a externalConnection object.
Delete externalConnection None Delete a externalConnection object.
Create schema None or schema Register connection schema.
Get operation connectionOperation Get the status of an asynchronous request to create the connection schema.
Create externalItem externalItem Create a new externalItem by posting to the items collection.


Property Type Description
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 Azure Active Directory 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, and limitExceeded. Required.


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.
groups microsoft.graph.externalConnectors.externalGroup collection Read-only. Nullable.

JSON representation

The following is a JSON representation of the resource.

  "description": "String",
  "id": "String (identifier)",
  "name": "String",
  "state": "String"