How to register an OAuth app for Acumatica

Register your app with Acumatica

Acumatica Integration page

If you can't find the Integration page, you can click on "More Items" and then click on "Integration" from the menu.

Acumatica More Items Integration page

Now click on the Connected Applications under the "Preferences"

Acumatica Connected Applications

Enter your application's registration information:

Client Name - Enter a meaningful application name that will be displayed to your users. Most of the time, this should be your company's name.
Flow - Select Authorization Code
Refresh Tokens - Select Absolute Expiration and 30 Days of Absolute lifetime
Redirect URI - Click on REDIRECT URIS and add
```
https://unify.apideck.com/vault/callback
```
as the redirect URI. This is the default redirect URI for Apideck.

Acumatica App Registration

Navigate to the SECRETS section and click on Add shared secret

Acumatica Secrets Section

Add a description and select an expiry time.

Note: Select a long expiry time to avoid having to re-authorize the app with new credentials in short periods of time.

Acumatica Secret Add Section

Click on the save icon to generate a new Client ID.

Acumatica Generate Client ID

Copy the Client ID and save it for later use.

Acumatica Copy Client ID

Your instance URL will be in the format:

https://yourinstance.acumatica.com/entity/DEFAULT/20.200.001

Base URL of your Acumatica instance should look like below:

Acumatica Base URL

To find the correct version for your instance URL, navigate to Web Service Endpoints under the Integration page.

Acumatica Instance URL Example

Enter the following credentials to setup the connection:

Acumatica Connection Settings

Once you've entered the credentials, click Save settings then Connect. You can now use the connection to retrieve data from Acumatica.