Exchange Online OAuth2 User Account

In this article

Overview

Use this account type to connect Exchange Online Snaps with data sources that use Exchange Online OAuth2 User accounts.

Prerequisites

Valid OAuth2 application with all the required API permissions.

Limitations

None.

Known Issues

None.

Account Settings

ParameterData TypeDescriptionDefault ValueExample 
LabelString

Required. Unique user-provided label for the account.

N/AExchange Online Account
Client IDStringRequired.  Enter the client ID associated with your Azure application. You can create the client ID as advised by your application provider. Refer Application Configuration in Azure Portal for OAuth2 Account to use in ExchangeN/A39dh47-86838725-1307264jgf-gsf331815
Client secretStringRequired. Enter the client secret associated with your account. You can create the client secret as advised by your application provider. Refer Application Configuration in Azure Portal for OAuth2 Account to use in ExchangeN/AN/A
Access tokenStringAuto-generated after authorization. The access token associated with the OAUth2 application is used to make API requests on behalf of the user associated with the client ID.N/AN/A
Refresh tokenStringAuto-generated after authorization. The refresh token associated with your account. If the refresh token is stored, then the access token can be refreshed automatically before it expires.N/AN/A
Access token expirationNumericAuto-generated after authorization. The access token expiration value.N/AN/A
OAuth2 EndpointString

RequiredEnter the authorization endpoint to authorize the application. Replace tenant id placeholder with the tenant id generated while creating OAuth2 application.

https://login.microsoftonline.com/<tenant-id>/oauth2/v2.0/authorizehttps://login.microsoftonline.com/413e110c-7d55-4f7b-947d-e3d423916beb/oauth2/v2.0/token
OAuth2 TokenStringRequired. Enter the token endpoint to get the access token. Replace tenant id placeholder with the tenant id generated while creating OAuth2 application.https://login.microsoftonline.com/<tenant-id>/oauth2/v2.0/tokenhttps://login.microsoftonline.com/413e110c-7d55-4f7b-947d-e3d423916beb/oauth2/v2.0/token
Token endpoint config

Use this fieldset to provide custom properties for the OAuth2 token endpoint. Click the + or - icons to respectively add or remove configuration rows.

This fieldset comprises the following fields:

  • Token endpoint parameter
  • Token endpoint parameter value
Token endpoint parameterStringDefines an optional token endpoint parameter value.N/Ascope
Token endpoint parameter valueStringProvides custom properties for the OAuth2 auth endpoint.N/Aoffline_access User.Read.All  Mail.ReadWrite    MailboxSettings.ReadWrite  Calendars.ReadWrite   Contacts.ReadWrite
Auth endpoint config

Use this fieldset to provide custom properties for the OAuth2 auth endpoint. Click the + or - icons to respectively add or remove configuration rows.

This fieldset comprises the following fields:

  • Auth endpoint parameter
  • Auth endpoint value
Auth endpoint parameterStringEnter the name of the endpoint authentication parameter.N/Ascope
Auth endpoint valueStringEnter the value corresponding to the endpoint authentication parameter.N/Aoffline_access User.Read.All  Mail.ReadWrite    MailboxSettings.ReadWrite  Calendars.ReadWrite   Contacts.ReadWrite
Auto-refresh tokenCheck boxSelect to refresh the token automatically using the refresh token. Otherwise, the token might expire and will not be automatically  refreshed.Not selectedSelected
AuthorizeButtonClick this button to acquire the required permissions for this account from the Slack app, when creating an account.N/AN/A

Troubleshooting

Error
Reason
Resolution
Authentication failed.You have entered an incorrect Client ID or Client secret.Check and ensure that you have provided the correct and valid Client ID and Client secret for the account and allowed the required access privileges to the application. 
Error in Authorization: Something went wrong when authorizing this app. Invalid client_id parameter.You have entered an incorrect Client ID.Check and correct the Client ID entered for the account and try authorizing the app again.



See Also