If you are planning to use any of the Microsoft 365, then you will need to setup an integration application. The application will authenticate with OAuth 2.0. Microsoft Graph is the API that the developer will work with for all Microsoft 365 endpoints. This API endpoint can connect to Microsoft Teams, SharePoint, Outlook, OneDrive, Yammer, and many others.

Create an Integration Application for Microsoft Graph API

1. To get start, an administrator will need to log into Azure portal. Next click on Azure Active Directory.

2. Copy the Tenant ID under Basic Information. Next click App registrations.

3. Select New registration.

4. Add a name for the application (Boomi Integration). Select the supported account type. Finally, select the Redirect URL. The URL will be https://platform.boomi.com/account/<account-id>/oauth2/callback. To find your account Id, log in to the Boomi Platform and go to Settings -> Account Information and Set Up -> Account -> Account Information.

5. After clicking save, the application overview will be displayed. Save the Application (client) Id. The tenant id will be the same as what was previously saved.

6. Next click on Certificates and Secrets. Then click on New Client Secret under the heading Client Secret.

7. Add a Description and select how long the client secret will be valid. If 6 months is selected, then a new client secret will need to be created and uploaded to Boomi every 6 months. Save the client secret that was created.

8. Next set up the API Permissions. Click on API Permissions and then Add A Permission.

9. Next select Microsoft Graph. There are other options below that are application specific, but Microsoft Graph will give the greatest flexibility.​​​

10. ​After selecting the application to be used, select Application permissions. This article reviews how to setup Microsoft Graph, but if you were using a different endpoint, then select a different API. To decide which permissions are required, use the Microsoft Graph documentation to help decide which resources to use.

​​​​​​​

11. Next, click on Authentication. Validate that the URL that was ended during Step 4 is correct and that Access Tokens is selected under Implicit Grant and Hybrid Flows.

12. Finally, get the authorization endpoint and the token endpoint Click on Overview -> Endpoint.

​​​​​​​Setup Connection Within Boomi

Create a new HTTP Client connector. Populate the fields with the below values and click on Generate

Field	Value
URL	https://graph.microsoft.com/v1.0
Authentication Type	OAuth 2.0
Grant Type	Authorization Credentials
Client ID	Client ID from Step 5
Client Secret	Client Secret from Step 7
Authorization Token URL	Step 12: https://login.microsoftonline.com//oauth2/v2.0/authorize
Scope	https://graph.microsoft.com/.default
Access Token URL	Step 12: https://login.microsoftonline.com//oauth2/v2.0/token

​​​​​​​An additional header needs to be se in all HTTP Client operations that are used. An Accept header must be set to /.

Article originally posted at Boomi Community.