In this article
Each account type separately. Maintain them as child pages of the main Accounts page. Remove Prerequisites, Limitations, and Troubleshooting from the main Accounts page if using this template.
Provide an overview of the account type.
Use this account type to connect OpenAPI Snaps with data sources that use OAuth2 accounts.
To create an OpenAPI OAuth2 account, ensure that your endpoint's account has:
See OpenAPI OAuth2 for details.
The configuration varies based on the OpenAPI version of your OpenAPI endpoint since the OpenAPI Snap supports both version 2 and 3.
Parameter | Data Type | Description | Default Value | Example |
---|---|---|---|---|
Label | String | Required. Provide a name for the account. We recommend that you update the account name if there is more than one account of the same account type in your project. | N/A | OpenAPI OAuth2 Account |
Client ID | String | Required. Enter the client ID associated with your account. You can create the client ID as advised by your application provider. | N/A | 3swddd3-4344-894b-90c201c91de |
Client secret | String | Required. Enter the client secret associated with your account. You can create the client secret as advised by your application provider. | N/A | 678753456 |
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. | N/A | 767886779 |
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. | N/A | 43923756 |
Access token expiration | Integer | Auto-generated after authorization. The access token expiration value, in seconds. | N/A | 12345 |
Header authenticated | Checkbox | Select this check box to indicate that the endpoint uses bearer header authentication. | Not selected | Selected |
OAuth2 Endpoint | URL | Required. Enter the URL of the endpoint that authorizes the application. | N/A | https://123-ABC-456.mktorest.com/rest/ |
OAuth2 Token | String | Required. Enter the URL of the endpoint that retrieves the token for an authenticated account. | N/A | https://123-ABC-456.mktorest.com/identity/oauth/token |
Grant Type | String | Select the method of authorization.
| authorization_code | client_credentials |
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 | String | Enter the token endpoint parameter. | N/A | scope |
Token endpoint value | String | Enter the value associated with the endpoint parameter defined above. | N/A | offline_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 | String | Enter the authorization endpoint parameter. | N/A | scope |
Auth endpoint value | String | Enter the value associated with the authorization endpoint parameter defined above. | N/A | offline_access User.Read.All Mail.ReadWrite MailboxSettings.ReadWrite Calendars.ReadWrite Contacts.ReadWrite |
Auto-refresh token | Checkbox | Select this check box to refresh the access token automatically using the refresh token. Otherwise, the access token expires and is not refreshed automatically. | Not selected | Selected |
Authorize | Button | Click this button to authorize the account using the credentials provided in the Client ID, Client Secret, OAuth2 Endpoint, and OAuth2 Token fields. We recommend that you click this button if this is the first time you are creating this account. | NA | NA |
Send Client Credentials as Basic Auth Header | Checkbox | Select this checkbox when you want to send the client information as a header to the OAuth endpoint. | Deselected | N/A |
Error | Reason | Resolution |
---|---|---|
One or more required field is blank | You click Authorize in the account dialog window, but one or more of the following fields is blank:
| Insert valid details into the following fields and click Authorize.
|
You attempted to authorize your account, but authorization failed. Thus, the following fields are empty:
You still click Apply. |
Provide links to the endpoint's official documentation, any relevant or related internal documentation, and any other links you have referred to on this page. Care should be taken when referencing external sites/documentation that it is an official site/documentation. Do not refer to forums such as stackoverflow.