Call the MS Graph REST API
- Topics:
- Workfront Fusion
Many Microsoft web services are accessed through the Microsoft Graph API. You can create a connection to the Microsoft Graph API, by using the Workfront Fusion HTTP > Make an OAuth 2.0 request module.
Access requirements
Expand to view access requirements for the functionality in this article.
You must have the following access to use the functionality in this article:
Adobe Workfront package | Any |
Adobe Workfront license |
New: Standard Or Current: Work or higher |
Adobe Workfront Fusion license** |
Current: No Workfront Fusion license requirement Or Legacy: Any |
Product |
New:
Or Current: Your organization must purchase Adobe Workfront Fusion. |
For more detail about the information in this table, see Access requirements in documentation.
For information on Adobe Workfront Fusion licenses, see Adobe Workfront Fusion licenses.
Register Workfront Fusion in the Microsoft Application Registration Portal
To create a connection to the Microsoft Graph REST API, you must first register Adobe Workfront Fusion.
-
Begin registering a new application as described in Register an application with the Microsoft identity platform in the Microsoft documentation.
As part of the registration, Microsoft requires the following information:
Application name Enter a name for the application, such as "My Workfront Fusion application." Redirect URL https://app.workfrontfusion.com/oauth/cb/oauth2
-
When you have completed the app registration, make note of the Application ID.
IMPORTANT
You will need the Application ID to set up your connection in Workfront Fusion. -
Generate a Client Secret. Make note of this secret.
For instructions, see Register an application with the Microsoft identity platform in the Microsoft documentation.
IMPORTANT
You will need the Client Secret to set up your connection in Workfront Fusion. -
Configure the permissions for your application.
For specifics on locating and configuring these fields, see the “Configure permissions for Microsoft Graph” section in Get access without a user in the Microsoft documentation.
What type of permissions does your application require?SelectDelegated permissions
.Select permissionsSelect the following permissions:
-
offline_access
-
openid
-
Any other permissions required by your integrations (Example:
User.Read
)
Important: You will need the selected permissions to set up your connection in Workfront Fusion.
-
-
Continue to Configure your MS Graph API connection in Workfront Fusion.
Configure your MS Graph API connection in Workfront Fusion
After you register Workfront Fusion as discussed in Register Workfront Fusion in the Microsoft Application Registration Portal, you can configure your connection in the HTTP > Make an Oauth 2.0 request module.
-
Add an HTTP > Make an OAuth 2.0 call module to your scenario.
-
Click Add next to the connection field.
-
Configure the connection fields as follows:
Connection nameEnter a name for the connection.EnvironmentSelect whether you are connecting to a production or non-production account.TypeSelect whether you are connecting to a service account or a personal account.Flow typeSelectAuthorization Code
.Authorize URIEnterhttps://login.microsoftonline.com/common/oauth2/v2.0/authorize
.Token URIEnterhttps://login.microsoftonline.com/common/oauth2/v2.0/token
.ScopeEnter the permissions that you selected in when registering, as discussed in Register Workfront Fusion in the Microsoft Application Registration Portal.
For each scope, click Add and type in the permission.
Example:
offline_access
.Scope separatorSelectSPACE
.Client IDEnter the Application ID from step 2 in Register Workfront Fusion in the Microsoft Application Registration Portal.Client SecretEnter the Client Secret that you generated in step 3 in Register Workfront Fusion in the Microsoft Application Registration Portal.Authorize parametersAdd the following Authorize parameters. For each parameter you are adding, click Add item and enter the following:
-
Key:
response_mode
Value:query
-
Key:
prompt
Value:consent
Access token parametersYou do not need to enter anything into this field.Refresh token parameters-
Click Add item.
-
In the Key field, enter
scope
. -
In the Value field, enter all of the scopes that you entered into the scope field, separated by spaces.
Example:
offline_access openid User.Read
Custom HeadersYou do not need to enter anything into this field.Token PlacementIn the header
-
-
Click Continue.
-
In the window that appears, click Accept to complete the connection and return to the module.