# How to connect to MYOB Acumatica

MYOB Acumatica connections use your **own** Connected Application: you register an app inside your MYOB Acumatica instance, then hand Apideck its Client ID, Client Secret and Instance URL. There is no shared Apideck app to authorize against, so the steps below have to be completed once per MYOB Acumatica instance you want to connect.

## Prerequisites

- A MYOB Acumatica instance, with a user that can reach the **Integration** workspace (registering a Connected Application is an administrator task).
- An API licence with room for one more web-services API user. The free **Full User API** licence allows **1,500 API calls per day** and **one named API user**; if that single API user is already driving another integration, this connection competes with it for the same allowance. The paid **Full Access API** licence removes both limits. It is a per-tenant MYOB licence: it lives on your own MYOB Acumatica account and is assigned there to the API user this connection signs in as, so it has to be arranged with MYOB: Apideck cannot raise the limit for you.

## 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)

The connector requests two OAuth scopes when you authorize: `api` (access to the web-services endpoints) and `offline_access` (the refresh token that keeps the connection alive without a fresh sign-in). The refresh-token settings above are what let that refresh token keep renewing itself.

### 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`

It is built from three parts, and all three have to be exact:

- The base URL of your own MYOB Acumatica instance, for example `https://yourinstance.myobadvanced.com`
- `/entity/` followed by the **endpoint name**, normally `DEFAULT` (uppercase)
- `/` followed by the **endpoint version**, for example `20.200.001`

Do not add a trailing slash, and do not point it at the sign-in page or at any `/entity/...` path copied from a browser tab other than the endpoint list.

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. The endpoint name and version shown there are the two values you append to your base URL.

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

## Notes

- **The API licence is yours to manage.** The free Full User API licence covers 1,500 API calls per day through a single named API user. Sharing that one API user between this connection and another integration means both draw on the same daily allowance. The Full Access API licence lifts the call cap and the single-user restriction; because it sits on your own MYOB Acumatica account and is assigned there to the API user this connection uses, arrange it with MYOB before connecting if you expect sustained volume.
- **Another integration on the same API user will contend with this connection.** MYOB Acumatica sessions are not built for parallel activity under one login, so a second integration signed in as the same named API user can throttle or time out alongside this one. Where your licence allows more than one API user, give this connection its own.
- **Client secrets expire.** When the shared secret you created in step 3 reaches its expiry date, the connection stops working until you add a new secret in MYOB Acumatica and reconnect in the Apideck Dashboard.

## Troubleshooting

- **Sign-in rejected because the API user limit is reached.** Your MYOB Acumatica licence sets a maximum number of web-services API users, and a sign-in that would exceed it is refused outright rather than queued. Free up an API user (or upgrade to the Full Access API licence) and try connecting again.
- **Authorization fails or data calls 404.** This is almost always the Instance URL. Re-check it against **Integration** > **Web Service Endpoints**: the endpoint name (`DEFAULT`) and the version number must match exactly, with no trailing slash.
- **Calls stop succeeding partway through the day.** On the free API licence you have 1,500 calls per day; a single GET that returns many records counts as one call, and a delete counts once per record removed.
- **Timeouts or throttling under load.** First check whether another integration is signed in as the same MYOB Acumatica API user as this connection, since parallel activity under one login is a common cause. If this connection is the only thing using that API user, raise the timeouts with the provider of the integration that reads your data.
- Still stuck? Contact [Apideck Support](https://help.apideck.com/en/articles/7774658).