Microsoft

Microsoft Graph: Search, connectors and change notifications

Search across mail, events, files, sites and external content, add your own content with Graph connectors, and subscribe to change notifications (webhooks)…

Data & analytics#openapi

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

Search across mail, events, files, sites and external content, add your own content with Graph connectors, and subscribe to change notifications (webhooks) for Graph resources.

This listing is one area of Microsoft Graph, the single REST API for Microsoft 365, Outlook, OneDrive, Teams and Microsoft Entra ID. It holds 94 of the area's requests, the most direct ones first, generated from Microsoft's own OpenAPI description of Graph v1.0. The other areas (mail, calendar, files, Teams, users and more) are listed separately on the Microsoft page.

Get an access token

  1. Sign in to the Microsoft Entra admin center and open App registrations > New registration. For a quick test, the Graph Explorer signs you in and shows a token without registering anything.
  2. Under API permissions, add the Microsoft Graph permissions this area needs, for example: depends on the content searched; Files.Read.All, Mail.Read, ExternalItem.ReadWrite.OwnedBy. Delegated permissions act as the signed-in user; application permissions act as the app itself and need an administrator's consent.
  3. Under Certificates & secrets, create a client secret (keep it out of shared collections).
  4. Get a token from https://login.microsoftonline.com/ /oauth2/v2.0/token: the authorization-code flow for a user, or grant_type=client_credentials with scope=https://graph.microsoft.com/.default for an app. Send it as Authorization: Bearer .

Using these requests

  • Base URL: https://graph.microsoft.com/v1.0. /me/... paths act on the signed-in user; with an application token use /users/{id or userPrincipalName}/... instead.
  • Shape responses with OData query parameters: $select (fields), $filter, $orderby, $top, $expand and $search (some need the ConsistencyLevel: eventual header). Long lists are paged: follow @odata.nextLink.
  • Combine up to 20 requests in one call with POST /$batch.

Common errors

StatusCodeWhat to do
401InvalidAuthenticationTokenThe token is missing, expired or for another resource: get a new one for https://graph.microsoft.com.
403Authorization_RequestDenied / ErrorAccessDeniedAdd the permission listed in the request's docs and grant consent.
404ResourceNotFound / itemNotFoundCheck the id; ids from another user or tenant are not found.
429TooManyRequestsThrottled: wait the Retry-After seconds, then retry.

Docs: Search, connectors and change notifications overview · Permissions reference · Throttling

Endpoints 94

Search

  • GETGet search/search
  • PATCHUpdate search/search
  • POSTCreate query/search/queryRuns the query specified in the request body. Search results are provided in the response.

External

  • GETGet external/external
  • PATCHUpdate external/external

Connections

  • GETList connections/connections
  • POSTCreate connection/connections
  • GETGet connection/connections/:externalConnection-id
  • DELETEDelete connection/connections/:externalConnection-id
  • PATCHUpdate connection/connections/:externalConnection-id
  • GETGet schema/connections/:externalConnection-id/schema
  • PATCHUpdate schema/connections/:externalConnection-id/schema

Subscriptions

  • GETList subscriptions/subscriptionsRetrieve the properties and relationships of webhook subscriptions, based on the app ID, the user, and the user's role with a tenant. The content of the…
  • POSTCreate subscription/subscriptionsSubscribes a listener application to receive change notifications when the requested type of changes occur to the specified resource in Microsoft Graph. To…
  • GETGet vapid public key (subscription)/subscriptions/getVapidPublicKey()Get the public key information required to validate push notifications according to RFC 8292 specifications.
  • GETGet subscription/subscriptions/:subscription-idRetrieve the properties and relationships of a subscription. See the table in the Permissions section for the list of resources that support subscribing to…
  • DELETEDelete subscription/subscriptions/:subscription-idDelete a subscription. For the list of resources that support subscribing to change notifications, see the table in the Permissions section.
  • PATCHUpdate subscription/subscriptions/:subscription-idRenew a subscription by extending its expiry time. The table in the Permissions section lists the resources that support subscribing to change notifications.…
  • POSTCreate reauthorize/subscriptions/:subscription-id/reauthorizeReauthorize a subscription when you receive a reauthorizationRequired challenge.

Search: qnas

  • GETList qnas/search/qnasGet a list of the qna objects and their properties.
  • POSTCreate qna/search/qnasCreate a new qna object.
  • GETGet qna/search/qnas/:qna-idRead the properties and relationships of a qna object.
  • DELETEDelete qna/search/qnas/:qna-idDelete a qna object.
  • PATCHUpdate qna/search/qnas/:qna-idUpdate the properties of a qna object.

Search: acronyms

  • GETList acronyms/search/acronymsGet a list of the acronym objects and their properties.
  • POSTCreate acronym/search/acronymsCreate a new acronym object.
  • GETGet acronym/search/acronyms/:acronym-idRead the properties and relationships of an acronym object.
  • DELETEDelete acronym/search/acronyms/:acronym-idDelete an acronym object.
  • PATCHUpdate acronym/search/acronyms/:acronym-idUpdate the properties of an acronym object.

Search: bookmarks

  • GETList bookmarks/search/bookmarksGet a list of bookmark objects and their properties.
  • POSTCreate bookmark/search/bookmarksCreate a new bookmark object.
  • GETGet bookmark/search/bookmarks/:bookmark-idRead the properties and relationships of a bookmark object.
  • DELETEDelete bookmark/search/bookmarks/:bookmark-idDelete a bookmark object.
  • PATCHUpdate bookmark/search/bookmarks/:bookmark-idUpdate the properties of a bookmark object.

External: connections

  • GETList connections/external/connectionsGet a list of the externalConnection objects and their properties.
  • POSTCreate connection/external/connectionsCreate a new externalConnection object.
  • GETGet connection/external/connections/:externalConnection-idRead the properties and relationships of an externalConnection object.
  • DELETEDelete connection/external/connections/:externalConnection-idDeletes an externalConnection object.
  • PATCHUpdate connection/external/connections/:externalConnection-idUpdate the properties of an externalConnection object.
  • GETList items/external/connections/:externalConnection-id/itemsRead the properties and relationships of an externalItem object.
  • POSTCreate item/external/connections/:externalConnection-id/items
  • GETList groups/external/connections/:externalConnection-id/groupsGet an externalGroup object.
  • POSTCreate group/external/connections/:externalConnection-id/groupsCreate a new externalGroup object.
  • GETGet schema/external/connections/:externalConnection-id/schemaRead the properties and relationships of a schema object.
  • PATCHUpdate schema/external/connections/:externalConnection-id/schemaCreate a new or update an existing schema for a Microsoft Search connection.
  • GETList operations/external/connections/:externalConnection-id/operationsRead the properties and relationships of a connectionOperation object.
  • POSTCreate operation/external/connections/:externalConnection-id/operations
  • GETGet item/external/connections/:externalConnection-id/items/:externalItem-idRead the properties and relationships of an externalItem object.
  • PUTReplace item/external/connections/:externalConnection-id/items/:externalItem-idCreate a new externalItem object.
  • DELETEDelete item/external/connections/:externalConnection-id/items/:externalItem-idDelete an externalItem object.
  • GETGet group/external/connections/:externalConnection-id/groups/:externalGroup-idGet an externalGroup object.
  • DELETEDelete group/external/connections/:externalConnection-id/groups/:externalGroup-idDelete an externalGroup object.
  • PATCHUpdate group/external/connections/:externalConnection-id/groups/:externalGroup-idUpdate the properties of an externalGroup object.
  • GETGet operation/external/connections/:externalConnection-id/operations/:connectionOperation-idRead the properties and relationships of a connectionOperation object.
  • DELETEDelete operation/external/connections/:externalConnection-id/operations/:connectionOperation-id
  • PATCHUpdate operation/external/connections/:externalConnection-id/operations/:connectionOperation-id
  • GETList members/external/connections/:externalConnection-id/groups/:externalGroup-id/membersA member added to an externalGroup. You can add Microsoft Entra users, Microsoft Entra groups, or an externalGroup as members.
  • POSTCreate member/external/connections/:externalConnection-id/groups/:externalGroup-id/membersCreate an identity resource for a new member in an externalGroup.
  • GETList activities/external/connections/:externalConnection-id/items/:externalItem-id/activitiesReturns a list of activities performed on the item. Write-only.
  • POSTCreate activity/external/connections/:externalConnection-id/items/:externalItem-id/activities
  • POSTCreate external connectors.add activity/external/connections/:externalConnection-id/items/:externalItem-id/microsoft.graph.externalConnectors.addActivitiesAppend additional instances of externalActivity objects on an externalItem.
  • GETGet member/external/connections/:externalConnection-id/groups/:externalGroup-id/members/:identity-idA member added to an externalGroup. You can add Microsoft Entra users, Microsoft Entra groups, or an externalGroup as members.
  • DELETEDelete member/external/connections/:externalConnection-id/groups/:externalGroup-id/members/:identity-idDelete an identity resource to remove the corresponding member from an externalGroup.
  • PATCHUpdate member/external/connections/:externalConnection-id/groups/:externalGroup-id/members/:identity-id
  • GETGet activity/external/connections/:externalConnection-id/items/:externalItem-id/activities/:externalActivity-idReturns a list of activities performed on the item. Write-only.
  • DELETEDelete activity/external/connections/:externalConnection-id/items/:externalItem-id/activities/:externalActivity-id
  • PATCHUpdate activity/external/connections/:externalConnection-id/items/:externalItem-id/activities/:externalActivity-id

Connections: items

  • GETList items/connections/:externalConnection-id/items
  • POSTCreate item/connections/:externalConnection-id/items
  • GETGet item/connections/:externalConnection-id/items/:externalItem-id
  • PUTReplace item/connections/:externalConnection-id/items/:externalItem-id
  • DELETEDelete item/connections/:externalConnection-id/items/:externalItem-id
  • GETList activities/connections/:externalConnection-id/items/:externalItem-id/activitiesReturns a list of activities performed on the item. Write-only.
  • POSTCreate activity/connections/:externalConnection-id/items/:externalItem-id/activities
  • POSTCreate external connectors.add activity/connections/:externalConnection-id/items/:externalItem-id/microsoft.graph.externalConnectors.addActivitiesAppend additional instances of externalActivity objects on an externalItem.
  • GETGet activity/connections/:externalConnection-id/items/:externalItem-id/activities/:externalActivity-idReturns a list of activities performed on the item. Write-only.
  • DELETEDelete activity/connections/:externalConnection-id/items/:externalItem-id/activities/:externalActivity-id
  • PATCHUpdate activity/connections/:externalConnection-id/items/:externalItem-id/activities/:externalActivity-id
  • GETGet performed by/connections/:externalConnection-id/items/:externalItem-id/activities/:externalActivity-id/performedByRepresents an identity used to identify who is responsible for the activity.

Connections: groups

  • GETList groups/connections/:externalConnection-id/groups
  • POSTCreate group/connections/:externalConnection-id/groups
  • GETGet group/connections/:externalConnection-id/groups/:externalGroup-id
  • DELETEDelete group/connections/:externalConnection-id/groups/:externalGroup-id
  • PATCHUpdate group/connections/:externalConnection-id/groups/:externalGroup-id
  • GETList members/connections/:externalConnection-id/groups/:externalGroup-id/membersA member added to an externalGroup. You can add Microsoft Entra users, Microsoft Entra groups, or an externalGroup as members.
  • POSTCreate member/connections/:externalConnection-id/groups/:externalGroup-id/members
  • GETGet member/connections/:externalConnection-id/groups/:externalGroup-id/members/:identity-idA member added to an externalGroup. You can add Microsoft Entra users, Microsoft Entra groups, or an externalGroup as members.
  • DELETEDelete member/connections/:externalConnection-id/groups/:externalGroup-id/members/:identity-id
  • PATCHUpdate member/connections/:externalConnection-id/groups/:externalGroup-id/members/:identity-id

Connections: operations

  • GETList operations/connections/:externalConnection-id/operations
  • POSTCreate operation/connections/:externalConnection-id/operations
  • GETGet operation/connections/:externalConnection-id/operations/:connectionOperation-id
  • DELETEDelete operation/connections/:externalConnection-id/operations/:connectionOperation-id
  • PATCHUpdate operation/connections/:externalConnection-id/operations/:connectionOperation-id

API details

Base URL
https://graph.microsoft.com/v1.0
Authentication
OAuth 2.0 (authorization code, client credentials flows)
Operations
94 operations on 42 pathsGET 38POST 20PATCH 18DELETE 16PUT 2
Main resources
External: connections 33Connections: items 12Connections: groups 10Connections 7Subscriptions 7Connections: operations 5Search: acronyms 5Search: bookmarks 5Search: qnas 5Search 3
Description format
OpenAPI 3.0.4, API version v1.0

How to test the Microsoft Graph: Search, connectors and change notifications in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the Microsoft Graph: Search, connectors and change notifications collection, without the publisher's secrets.
  3. Add your credentialsThis API uses OAuth 2.0 (authorization code, client credentials flows). Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “Get search” (GET /search), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the Microsoft Graph: Search, connectors and change notifications?

Search across mail, events, files, sites and external content, add your own content with Graph connectors, and subscribe to change notifications (webhooks)… It is listed under Data & analytics and has 94 endpoints.

Who publishes the Microsoft Graph: Search, connectors and change notifications?

It is listed from Microsoft's public API description (an OpenAPI document), not published by Microsoft on Swastik Codes. Anyone who controls microsoft.com can claim the profile by adding a DNS TXT record.

What is the base URL of the Microsoft Graph: Search, connectors and change notifications?

Requests go to https://graph.microsoft.com/v1.0. Endpoint paths are added to this base URL.

How do I authenticate with the Microsoft Graph: Search, connectors and change notifications?

With OAuth 2.0 (authorization code, client credentials flows).

How many endpoints does the Microsoft Graph: Search, connectors and change notifications have?

94 operations on 42 paths (38 GET, 20 POST, 18 PATCH, 16 DELETE, 2 PUT). The largest groups are External: connections, Connections: items, Connections: groups, Connections.

Is forking the Microsoft Graph: Search, connectors and change notifications free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.