externalConnection resource type

Namespace: microsoft.graph


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.


Microsoft Graph connectors and are currently in public preview status. To gain access to connectors functionality, you must turn on the Targeted release option in your tenant. See more details on the connectors preview program.


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 configuration Specifies additional application IDs that are allowed to manage the connection and to index content in the connection. 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. Maximum length of 32 characters. Must only contain alphanumeric characters. Cannot begin with Microsoft or be one of the following values: None, Directory, Exchange, ExchangeArchive, LinkedIn, Mailbox, MicrosoftSearch, OneDriveBusiness, SharePoint, Teams, Yammer, 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.
state connectionState Indicates the current state of the connection. Possible values are draft, ready, obsolete, and limitExceeded. Required.


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

JSON representation

The following is a JSON representation of the resource.

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