# How to register an OAuth app for MYOB Acumatica

## Register your app with MYOB Acumatica

### 1. Create a new app

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

![MYOB Acumatica Integration page](https://res.cloudinary.com/apideck/image/upload/v1743599886/docs/connectors/myob-acumatica/myob-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.

![MYOB Acumatica More Items Integration page](https://res.cloudinary.com/apideck/image/upload/v1743599886/docs/connectors/myob-acumatica/myob-acumatica-integration-page-more-items.png)

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

![MYOB Acumatica Connected Applications](https://res.cloudinary.com/apideck/image/upload/v1743599886/docs/connectors/myob-acumatica/myob-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.

![MYOB 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**

![MYOB 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.

![MYOB 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.

![MYOB 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.

![MYOB 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.myobadvanced.com/entity/DEFAULT/20.200.001`

Base URL of your MYOB Acumatica instance should look like below:

![MYOB Acumatica Base URL](https://res.cloudinary.com/apideck/image/upload/v1743599885/docs/connectors/myob-acumatica/myob-acumatica-base-url.png)

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

![MYOB 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 MYOB Acumatica](https://platform.apideck.com/configuration/accounting/myob-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/v1743599886/docs/connectors/myob-acumatica/myob-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 MYOB Acumatica.