Use Postman to try the Microsoft Graph connectors API
The Microsoft Graph Postman collection includes sample requests for the connectors API. Developers can use Postman to try the API without writing any code.
Prerequisites
- Fork the Microsoft Graph Postman collection.
- Add the
ExternalConnection.ReadWrite.OwnedBy
andExternalItem.ReadWrite.OwnedBy
permissions to the app registration created for Postman. - Use Postman to authenticate with app-only authentication.
Connectors API requests are located in the Application -> Graph Connectors folder.
Create a new connection
Find the Create connection sample request in the Connection setup folder. Use this sample request to create a new connection. The Connection setup folder also contains other sample requests for managing connections.
Register connection schema
Find the Register schema sample request in the Connection setup -> Manage schema folder. Use this sample request to register a schema for the connection you created. This request returns a response that looks like the following.
HTTP/1.1 202 Accepted
Location: https://graph.microsoft.com/v1.0/external/connections/sampleConnectionId/operations/616bfeed-666f-4ce0-8cd9-058939010bfc
Registering a schema is an asynchronous operation. The URL returned in the Location
header should be polled for the status of this operation until the status is completed
. Find the Get operation status sample request in the Connection setup folder. Replace the request URL with the value in the Location
header and send the request to check status. This request returns a response that looks like the following.
HTTP/1.1 200 OK
Content-type: application/json
{
"id": "616bfeed-666f-4ce0-8cd9-058939010bfc",
"name": "Sample connection",
"status": "inprogress",
"error": null
}
Resend the request until the status
property is set to completed
. Wait at least one minute between resending this request.
The Manage schema folder also contains other sample requests for managing connections.
Add external group member (optional)
If your external service uses non-Microsoft Entra ID access control lists (ACLs), sync those permissions. External groups (along with Microsoft Entra ID users and groups) are used to set permissions on externalItems
added to a Microsoft Graph connection. For details, see externalGroup.
Sample requests for creating external groups and adding members are located in the Identity Sync folder.
Ingest items
Note
Do not ingest items into the connection until the connection schema is in the completed
state.
Find the Put item sample request in the Content sync folder. Use this sample request to ingest an item. The Content sync folder also contains other sample requests for managing items.
Error handling
For details about how to resolve errors, see Resolve Microsoft Graph authorization errors.
Related content
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기