> ## Documentation Index
> Fetch the complete documentation index at: https://nango-marcin-get-deployments-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Acumatica - How do I link my account?

# Overview

To authenticate with Acumatica using the Resource Owner Password Credentials flow, you will need:

1. **Instance URL** — The hostname of your Acumatica ERP instance (e.g. `mycompany.acumatica.com`)
2. **Client ID** — The client ID assigned to your connected application, including the tenant suffix (e.g. `88358B02-A48D-A50E-F710-39C1636C30F6@MyTenant`)
3. **Client Secret** — The client secret created for your connected application
4. **Username** — The username of an Acumatica ERP user
5. **Password** — The password for the specified username

This guide will walk you through obtaining each of these values.

### Prerequisites

* An active Acumatica ERP instance with administrator access
* Permission to manage connected applications in Acumatica

### Instructions

#### Step 1: Open Connected Applications

In Acumatica ERP, go to **System** → **Integration** → **Configure** → **Connected Applications** (SM303010).

#### Step 2: Create a new application

1. In the **Client Name** field, enter a name for your application. Leave **Client ID** blank — the system auto-generates it on save.
2. In the **OAuth 2.0 Flow** dropdown, select **Resource Owner Password Credentials**.

#### Step 3: Add a client secret

1. Click **Add Shared Secret**.
2. Enter a description and optionally an expiration date.
3. Click **OK** and copy the secret value immediately.

   <Warning>The secret value is shown only once. Store it securely and never expose it in client-side code, logs, or URLs.</Warning>

#### Step 4: Configure scopes

On the **Scopes** tab, add the `api` and `offline_access` scopes. The `offline_access` scope is required so Acumatica issues a refresh token — without it, your connection will stop working once the access token expires.

<Warning>Do not add `api:concurrent_access` — it can cause token request failures.</Warning>

#### Step 5: Save to activate

Click **Save**. Once saved, copy your **Client ID** from the application record.

<Note>The Client ID includes an auto-generated string and the tenant ID, for example `88358B02-A48D-A50E-F710-39C1636C30F6@MyTenant`. Copy the full value including the `@TenantId` suffix.</Note>

#### Step 6: Identify your instance URL

Your instance URL is the hostname you use to access Acumatica. For example, if you access Acumatica at `https://mycompany.acumatica.com`, your instance URL is `mycompany.acumatica.com`.

#### Step 7: Enter credentials in the Connect UI

1. Open the form where you need to authenticate with Acumatica.
2. Enter your **Instance URL** (hostname only, without `https://`).
3. Enter your **Username** and **Password** for the Acumatica ERP user.
4. Enter your **Client ID** (the full value including the `@TenantId` suffix).
5. Enter your **Client Secret**.
6. Submit the form.

<img src="https://mintcdn.com/nango-marcin-get-deployments-docs/VQPEYczYkyQcDMBH/api-integrations/acumatica/form.png?fit=max&auto=format&n=VQPEYczYkyQcDMBH&q=85&s=020aaa2e38addc2b1e7bd4a08bcde659" alt="Acumatica connection form with fields for Client ID, Client Secret, and instance URL" style={{maxWidth: "450px" }} width="986" height="1300" data-path="api-integrations/acumatica/form.png" />

You are now connected to Acumatica.

***