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
ExampleExchange Online OAuth2 User Account

String

Specify a unique name for the account.

Client ID*


Default Value: N/A
Example39dh47-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
Exampleoffline_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