Exact Online OAuth 2.0 Account

Overview

You can use this account type to connect Exact Online Snaps with an Exact Online instance using OAuth 2.0 authentication.



Prerequisites

  • Valid Exact Online Login account (valid user name and password)
  • Valid client application (valid Client ID and Client Secret)

Account settings

Call-back Domain: The redirect URI must be set differently in the app that is created in the endpoint: https://<SnapLogic_control_plane>/api/1/rest/admin/oauth2callback/rest

For example: https://elastic.snaplogic.com/api/1/rest/admin/oauth2callback/rest

Legend:
  • Expression icon (): Allows using JavaScript syntax to access SnapLogic Expressions to set field values dynamically (if enabled). If disabled, you can provide a static value. Learn more.
  • SnapGPT (): Generates SnapLogic Expressions based on natural language using SnapGPT. Learn more.
  • Suggestion icon (): Populates a list of values dynamically based on your Snap configuration. You can select only one attribute at a time using the icon. Type into the field if it supports a comma-separated list of values.
  • Upload : Uploads files. Learn more.
Learn more about the icons in the Snap settings dialog.
Field/Field set Description

Label

String

Required. Specify the name for the account. We recommend you update the account name if there is more than one account in your project.

Default value: N/A

Example: Exact Online OAuth2 Account
Client ID

String

Required. Specify the client ID associated with your account. You can create the client ID as advised by your application provider. Learn more about obtaining Client ID and Client Secret.

Default value: N/A

Example: p364e45x-953x-460p-9pb0-934xep16p693
Client secret

String

Required. Specify the client secret associated with your account. You can create the client secret as advised by your application provider. Learn more about obtaining Client ID and Client Secret.

Default value: N/A

Example: aBC232320mxyz=
Access token

String

Auto-generated after authorization. The token that SnapLogic uses to make API requests on behalf of the user associated with the client ID.

Default value: N/A

Example: 78456578
Refresh token

String

Auto-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.

Default value: N/A

Example: 157842
Access token expiration

Integer

Auto-generated after authorization. The access token expiration value, in seconds.

Default value: Current Time + 3600 seconds

Example: 1612279710
OAuth2 Endpoint

String

Required. Specify the URL of the endpoint that authorizes the application.

Default value: N/A

Example: https://start.exactonline.nl/api/oauth2/auth
OAuth2 Token

String

Required. Specify the URL of the endpoint that retrieves the token for an authenticated account.

Default value: N/A

Example: https://start.exactonline.nl/api/oauth2/token
Token endpoint config

Fieldset

Use this field set to configure token endpoint parameters as necessary for the account. This field set comprises the following fields:

  • Token endpoint parameter
  • Token endpoint parameter value
Token endpoint parameter

String

Provide the name for the token endpoint parameter.

Default value: N/A

Example: scope, redirect_uri
Token endpoint parameter value

String

Provide the value for the parameter, typically the default scope or a redirect_uri.

Default value: N/A

Example: .default
Auth endpoint config

Fieldset

Use this field set to provide custom properties for the OAuth2 auth endpoint. Click + or - to respectively add or remove configuration rows. This field set comprises the following fields:

  • Auth endpoint parameter
  • Auth endpoint value
Auth endpoint parameter

String

Specify the name for the auth endpoint parameter.

Default value: N/A

Example: scope
Auth endpoint value

String

Specify the value for the endpoint parameter defined above.

Default value: N/A

Example: read_orders, write_orders
Auto-refresh token

Checkbox

Select this checkbox to refresh the token automatically using the refresh token, if the property is enabled. If this property is deselected, the token expires and is not refreshed automatically.

Default value: Deselected
Authorize

Button

Click this button to authorize the Exact Online OAuth2 account using the credentials provided in the Client ID, Client Secret, OAuth2 Endpoint, and OAuth2 Token fields.
Refresh

Button

Click this button to refresh the access token using the credentials provided in the Client ID, Client Secret, OAuth2 Token, and Refresh token fields.

After configuring the account, click Authorize. SnapLogic sends your account details to the OAuth2 endpoint specified and populates the Access token, Refresh token, and Access token expiration fields using the details received from that endpoint.

Troubleshooting

Error Reason Resolution
Account validation failed.

The Pipeline ended before the batch could complete execution due to a connection error.

Verify that the Refresh token is configured to handle the inputs properly. If you are not sure when the input data is available, configure this field as 0 to keep the connection always open.