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. The Exchange Online OAuth2 User Account has limited user permissions as you do not require all the permissions in the Microsoft Azure Portal. The User Account is typically used when an individual user needs access to the Exchange Online mailbox. This method allows the application or service to interact with the user's Exchange Online mailbox on their behalf. Refer to this example to know when to use the Exchange Online OAuth2 User Account.

Prerequisites

Valid Azure application in Azure portal with the required API permissions.

Limitations and Known Issues

None.

AccountĀ Settings

Ā 

  • Asterisk ( * ): Indicates a mandatory field.

  • Suggestion icon ( ): Indicates a list that is dynamically populated based on the configuration.

  • Expression icon ( ): Indicates the value is an expression (if enabled) or a static value (if disabled). Learn more about Using Expressions in SnapLogic.

  • Add icon ( ): Indicates that you can add fields in the fieldset.

  • Remove icon ( ): Indicates that you can remove fields from the fieldset.

Field

Field Type

Description

Field

Field Type

Description

Label*


Default Value: None
Example:Ā Exchange Online OAuth2 User Account

String

Specify a unique name for the account.

ClientĀ ID*


Default Value: N/A
Example:Ā 39dh47-86838725-1307264jgf-gsf331815

String

Specify the client ID associated with your Azure application. You can create the client ID as advised by your application provider.Ā Learn more about how to generate Client ID:Ā Application Configuration inĀ Azure Portal for OAuth2 Account to use in Exchange OnlineĀ 

Client secret*


Default Value: N/A
Example: <Encrypted>

String

Specify theĀ client secret associated with your account. You can create the client secret as advised by your application provider.Ā Learn more about how to generate Client Secret:Ā Application Configuration inĀ Azure Portal for OAuth2 Account to use in Exchange Online

Access token


Default Value: N/A
Example:Ā <Encrypted>

String

Auto-generated after authorization.Ā 
Specify the access token associated with theĀ OAUth2 applicationĀ isĀ used to make API requests on behalf of the user associated with the client ID.

Refresh token


Default Value: N/A
Example:<Encrypted>

String

Auto-generatedĀ after authorization.Ā 
Specify the refresh token associated with your account.Ā If the refresh token is stored, then the access token can be refreshed automatically before it expires.

Access token expiration


Default Value: N/A
Example: 4532291

Integer

Auto-generatedĀ after authorization.Ā 

Specify the duration till which the access token remains active.

OAuth2 Endpoint*


Default Value: https://login.microsoftonline.com/<tenant-id>/oauth2/v2.0/authorize
Example:Ā https://login.microsoftonline.com/421e110c-7e44-4f7b-757d-e3d423916beb/oauth2/v2.0/authorize

String

Specify theĀ authorization endpoint to authorize the application. Replace tenant ID placeholder with the tenant ID generated while creating OAuth2 application.

OAuth2 Token*


Default Value: https://login.microsoftonline.com/<tenant-id>/oauth2/v2.0/token
Example:Ā https://login.microsoftonline.com/413e110c-7d55-4f7b-947d-e3d423916beb/oauth2/v2.0/token

String

Specify the token endpoint to getĀ the access token. Replace tenant ID placeholder with the tenant ID generated while creating OAuth2 application.

Token endpoint config





Use this field set to provide custom properties for the OAuth2 token endpoint.

Token endpoint parameter


Default Value: N/A
Example: scope

String

Defines an optional token endpoint parameter value.

Token endpoint parameter value


Default Value: N/A
Example: offline_access User.ReadĀ  Mail.ReadWriteĀ  Ā MailboxSettings.ReadWriteĀ  Calendars.ReadWriteĀ Ā  Contacts.ReadWrite

String

Provides custom properties for the OAuth2 auth endpoint.

Auth endpoint config





Use this field set to provideĀ custom properties for the OAuth2 auth endpoint.Ā 

AuthĀ endpointĀ parameter


Default Value: N/A
Example: scope

String

Specify the name of the endpoint authentication parameter.

AuthĀ endpointĀ value


Default Value: N/A
Example:Ā offline_accessĀ  User.ReadĀ Mail.ReadWriteĀ Ā Ā  MailboxSettings.ReadWriteĀ  Calendars.ReadWriteĀ Ā  Contacts.ReadWrite

String

Specify the value corresponding to the endpoint authentication parameter.


Troubleshooting

Error

Reason

Resolution

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.

Snap Pack History


Related content