# How to register an OAuth app for Acumatica

## Register your app with Acumatica

### 1. Create a new app

Login to your Acumatica account and go to the "Integration" page from the navigation menu.

![Acumatica Integration page](https://res.cloudinary.com/apideck/image/upload/v1735831090/docs/connectors/acumatica/acumatica-integration-page.png)

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](https://res.cloudinary.com/apideck/image/upload/v1735831273/docs/connectors/acumatica/acumatica-integration-page-more-items.png)

Now click on the **Connected Applications** under the "Preferences"

![Acumatica Connected Applications](https://res.cloudinary.com/apideck/image/upload/v1735831090/docs/connectors/acumatica/acumatica-integration-page.png)

### 2. Enter app details

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 **Sliding Expiration** and Infinite on Absolute lifetime. Enter 15 Days for **Sliding 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](https://res.cloudinary.com/apideck/image/upload/v1737616394/docs/connectors/acumatica/acumatica-app-registration.png)

### 3. Generate Client Secret

Navigate to the **SECRETS** section and click on **Add shared secret**

![Acumatica Secrets Section](https://res.cloudinary.com/apideck/image/upload/v1735831522/docs/connectors/acumatica/acumatica-secrets.png)

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](https://res.cloudinary.com/apideck/image/upload/v1735831692/docs/connectors/acumatica/acumatica-secret-add.png)

### 4. Generate Client ID

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

![Acumatica Generate Client ID](https://res.cloudinary.com/apideck/image/upload/v1735831842/docs/connectors/acumatica/acumatica-generate-client-id.png)

Copy the Client ID and save it for later use.

![Acumatica Copy Client ID](https://res.cloudinary.com/apideck/image/upload/v1735831914/docs/connectors/acumatica/acumatica-copy-client-id.png)

### 5. How to find your Instance URL

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](https://res.cloudinary.com/apideck/image/upload/v1735834099/docs/connectors/acumatica/acumatica-base-url.png)

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

![Acumatica Instance URL Example](https://res.cloudinary.com/apideck/image/upload/v1735878904/docs/connectors/acumatica/acumatica-instance-url.png)

### 6. Configure in Apideck

Head over to the [Apideck dashboard for Acumatica](https://platform.apideck.com/configuration/accounting/acumatica)

Enter the following credentials to setup the connection:

- Client ID
- Client Secret
- Instance URL

![Acumatica Connection Settings](https://res.cloudinary.com/apideck/image/upload/v1735881464/docs/connectors/acumatica/acumatica-connection-settings.png)

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